How to Make the Flexibility Options for Export Records in Websites that Generated with PHPMaker 9.0.1

Another great feature in PHPMaker 9 is the ability to define which records will be exported to the certain media/files. There are three options available that you can choose from PHP tab -> List/View Page Options (Global) sub-tab -> Export groupbox -> Export Type selection. The first option is All pages which means that records in all pages are exported. The second option is Current page which means that all records in current page are exported. And the last/third option is Selected records which means a checkbox will be displayed in each row for selection. Only selected records in the current page are exported (selecting records in different pages is not allowed). To select records primary key is required, Current Page export type will be used for tables without primary key.

Unfortunately, PHPMaker 9 only allows you to choose one of the three options above. If — for example — someday you want to switch from the current option to another, then you have to change it from your PHPMaker project application, afterwards you have to re-generate all the related pages that contain this export feature. Imagine now if you have to re-generate the hundred pages and then you have to re-upload them again to your web server. I think there should be another efficient and effective way to overcome this issue, right?

Well, I have successfully customized the PHPMaker template in order to make it come true. Besides that, there is a new constant I added into the configuration (ewcfg9.php) file. Now you only need to change this constant value and save the change, afterwards, your users will use the new settings in all pages that contain the export feature. In other words, you don’t have to re-generate your .php files anymore each time you want to change from the old option to the new option of the three options above.

If you disable Use global settings from the Table setup of PHPMaker, then the export setting that belongs to the table will being used. In other words, this customization will also handle the possibility of using the table setting instead of the global setting that derived from the constants value in the configuration file.

Since this customization is related to the article titled How to Restrict the Permission Access in “Export to …” Feature in Websites that Created with PHPMaker 9.0.1, then you have to implement the customization in that article first before doing this customization below. So, please make sure you have already implemented the customization in that article!

Updated on May 30, 2012: This customization has been implemented in PHPMaker version 9.0.2, it matches to each other, and as a result, it works properly.

Updated on July 22, 2012: This customization has been implemented in PHPMaker version 9.0.3, it matches to each other, and as a result, it works properly.

Updated on September 4, 2012: This customization has been implemented in PHPMaker version 9.0.4, it matches to each other, and as a result, it works properly.

Updated on November 28, 2012: This customization has been implemented in PHPMaker version 9.1.0, it matches to each other, and as a result, it works properly.

Updated on February 9, 2013: This customization has been implemented in PHPMaker version 9.2.0, it matches to each other, and as a result, it works properly.

Updated on June 17, 2013: This customization below has been handled by using MasinoFixedWidthSite extension. You don’t need to implement the customization below if you use my extensions together with the original PHPMaker Template and Extension files.

[hidepost]

Open your \Script\ewcfg.php file, and find this code:

// General

before that line, please insert the following code:

// Begin of mofidication Flexibility of Export Records Options, by Masino Sinaga, May 14, 2012
<!--## if (PROJ.ExportType == "SELECTED") { ##-->
define("MS_EXPORT_RECORD_OPTIONS", "selectedrecords", TRUE); // available values: "allpages", "currentpage", "selectedrecords"
<!--## } else if (PROJ.ExportType == "ALL") { ##-->
define("MS_EXPORT_RECORD_OPTIONS", "allpages", TRUE); // available values: "allpages", "currentpage", "selectedrecords"           
<!--## } else { ##-->
define("MS_EXPORT_RECORD_OPTIONS", "currentpage", TRUE); // available values: "allpages", "currentpage", "selectedrecords"           
<!--## } ##-->
// End of modification Flexibility of Export Records Options, by Masino Sinaga, May 14, 2012

As you can see from the customization, we can define the default value for MS_EXPORT_RECORD_OPTIONS based on the related value in PHPMaker application -> PHP -> List/View Page Options (Global) -> Export -> Export type.

Open your \Script\info.php file, and find this code:

		$this->ExportAll = <!--##=ew_Val(bExportAll)##-->;