| 23 | | |
| 24 | | == Upgrade 3.1 -> 3.2 == |
| 25 | | |
| 26 | | |
| 27 | | === PEAR MDB2 package === |
| 28 | | If you want to use database joins, XY layers or certain functions for the search (suggest, options) you need to install the PEAR [http://pear.php.net/package/MDB2 MDB2] database package. This substitutes the outdated DB package. Use the PEAR package manager to install the package, like |
| 29 | | |
| 30 | | {{{ |
| 31 | | pear install MDB2 |
| 32 | | pear install MDB2#pgsql |
| 33 | | pear install MDB2#mysqli |
| 34 | | ... (for all other database packages you want) |
| 35 | | }}} |
| 36 | | |
| 37 | | For more details about PEAR go to the [http://pear.php.net/manual/en/ online documentation]. |
| 38 | | |
| 39 | | If you still need to use the older PEAR DB (e.g. to use ODBC connections) install the DB package |
| 40 | | {{{ |
| 41 | | pear install DB |
| 42 | | }}} |
| 43 | | and add in your {{{config_xyz.ini}}} the following entry |
| 44 | | {{{ |
| 45 | | pearDbClass = DB |
| 46 | | }}} |
| 47 | | |
| 48 | | === PEAR Spreadsheet package === |
| 49 | | If you want to use the export plugin and the export to Excel files you need to install the PEAR Spreadsheet package: |
| 50 | | {{{ |
| 51 | | pear install -f OLE |
| 52 | | pear install -f Spreadsheet_Excel_Writer |
| 53 | | }}} |
| 54 | | |
| 55 | | |
| 56 | | |
| 57 | | === Configuration parameters === |
| 58 | | |
| 59 | | ==== config.ini->config_default.ini ==== |
| 60 | | |
| 61 | | Default config file must be called {{{config_default.ini}}} instead of {{{config.ini}}}. |
| 62 | | Config files for common settings of different applications are under {{{/config/common/}}}. |
| 63 | | |
| 64 | | {{{config_common.ini}}} can be used to store common settings |
| 65 | | of multiple {{{*.ini}}} files |
| 66 | | |
| 67 | | |
| 68 | | |
| 69 | | ==== map.phtml ==== |
| 70 | | |
| 71 | | |
| 72 | | for using the DHTML scalebar plugin it is necessary to create an entry below ''<div id="map" ...>'' like |
| 73 | | {{{ |
| 74 | | <div id="map" class="baselayout"> |
| 75 | | .... |
| 76 | | <div id="scaleReference"> |
| 77 | | <div id="scalebar"></div> |
| 78 | | </div> |
| 79 | | |
| 80 | | }}} |
| 81 | | |
| 82 | | |
| 83 | | all !JavaScript must be referenced with these settings |
| 84 | | {{{ |
| 85 | | <?php |
| 86 | | echo $jsConfigReference; |
| 87 | | echo $jsReference; |
| 88 | | include("$PM_INCPHP_LOCATION/js_init.php"); |
| 89 | | ?> |
| 90 | | }}} |
| 91 | | |
| 92 | | the attribute search UI elements are added with the following entry: |
| 93 | | {{{ |
| 94 | | <form id="searchForm" action="blank.html" onsubmit="submitSearch()" onkeypress="return disableEnterKey(event)"> |
| 95 | | <?php echo writeSearchContainer("inline") ?> |
| 96 | | </form> |
| 97 | | }}} |
| 98 | | |
| 99 | | ==== Context menus ==== |
| 100 | | |
| 101 | | Context menus require an entry in {{{js_config.php}}} adding the !JavaScript variable {{{pmContextMenuList}}}. See the samples how to define the menus in [http://www.json.org JSON] notation, adding them to an HTML DOM element defined with {{{bindto:}}} in [http://jquery.com/ jQuery] notation. |
| 102 | | |
| 103 | | |
| 104 | | ==== print settings ==== |
| 105 | | |
| 106 | | All print settings are configured via the {{{print.xml}}} file located under {{{/config/common/}}}. The XML settings are transformed into HTML, most tags available in HTML should work if strict rules for [http://www.w3.org/TR/2000/REC-xhtml1-20000126 XHTML] are followed. |
| 107 | | {{{ |
| 108 | | <html> HTML definition for standard (HTML) print page; is used from within printmap.phtml |
| 109 | | <printdlg> HTML definition print dialog; is used from within printdlg.phtml |
| 110 | | }}} |
| 111 | | |
| 112 | | a string included between {{{@[]@}}} like {{{@[Scale]@}}} is translated into the available languages. |
| 113 | | |
| 114 | | There are several predefined variables that can be included in the XML file. The variables must start with {{{$$}}} |
| 115 | | |
| 116 | | {{{ |
| 117 | | $$printTitle $$printScale $$printLegend |
| 118 | | $$printUrlList[0]: main map image URL |
| 119 | | $$printUrlList[1]: reference map URL |
| 120 | | $$printUrlList[2]: scalebar image URL |
| 121 | | }}} |
| 122 | | |
| 123 | | |
| 124 | | ---- |
| 125 | | |
| 126 | | == Upgrade 3.0 -> 3.1 == |
| 127 | | |
| 128 | | === PHP version === |
| 129 | | p.mapper 3.1 only runs fully on PHP 5.x with XML support because the attribute search requires PHP5 XML functions. |
| 130 | | |
| 131 | | === Attribute search === |
| 132 | | See [DocManualsearch » here ] for search definition via XML file |
| 133 | | |
| 134 | | |
| 135 | | |
| 136 | | === config.ini === |
| 137 | | new config tags (if not set, default values are taken): |
| 138 | | * pm_search_configfile |
| 139 | | * autoIdentifyGroups |
| 140 | | * catInfoLink/grpInfoLink |
| 141 | | * catWithCheckbox |
| 142 | | * debugLevel |
| 143 | | See the [DocManual#ConfigurationOptionsoftheINIFile p.mapper manual] for details. |
| 144 | | |
| 145 | | === php_config.php === |
| 146 | | Additionally to toolbars, now also DHTML menus are supported. The definition is done via the ''menu1'' array. Multiple menus are possible. Menus are created in the ''map.phtml'' via the function call {{{writemenu($menu1, "menu1", "Tools")}}} |
| 147 | | |
| 148 | | |
| 149 | | === js_config.php === |
| 150 | | various JS specific settings are added. See the file itself and the descriptions of the parameters there. |
| | 23 | [UpgradeOlderVersions Upgrade information for older versions see here] |