--- README.txt 2007-03-01 10:40:42.000000000 -0500 +++ mapbuilder_directions.txt 2007-03-03 20:47:01.000000000 -0500 @@ -1,59 +1,80 @@ -REQUIREMENTS +Installing mapbuilder on Drupal 5.1 -This module requires: -- the community mapbuilder library; I suggest the stable release of mapbuilder. - Use the zip download, or alternatively the src download if you want to read - or make changes to the mapbuilder sources. -- PHP 5 with support for DOM functions; when building PHP yourself use the - --with-xml and --with-curl configuration options -- the curl extension for php (e.g. package php5-curl under debian linux) +1. Requirements + + PHP5 (compiled with --with-curl and --with-xml) + + mapbuilder-5.x-1.x-dev.tar.gz from http://drupal.org/project/mapbuilder + + mapbuilder-lib-1.0.1-release.zip from http://docs.codehaus.org/display/MAP/Downloads + +2. Upload mapbuilder-5.x-1.x-dev.tar.gz to sites/all/modules. -REMARKS +3. tar xzf mapbuilder-5.x-1.x-dev.tar.gz -This code is tested with Firefox 1.5 under Debian/GNU Linux. No modifications -to mapbuilder sources were needed. + This creates the mapbuilder directory. -Steps to test: +4. Upload mapbuilder-lib-1.0.1-release.zip to sites/all/modules/mapbuilder (that + is, to the newly created directory) -1) in the mapbuilder folder extract the community mapbuilder sources - e.g. in mapbuilder-src +5. cd sites/all/modules/mapbuilder -2) enable the mapbuilder module in admin/modules +6. unzip mapbuilder-lib-1.0.1-release.zip -3) check the location of the mapbuilder library in admin/settings/mapbuilder +7. In the following file sites/all/modules/mapbuilder/demo/config.xml -4) add an input format in admin/filters for mapbuilder and choose the filters + Check the relative paths in and and make + sure they match your installation. + +8. Enable the mapbuilder module at admin/modules + +9. Check paths at admin/settings/mapbuilder and revise if necessary. (The HTML + template does not need to be revised.) + +10. Add mapbuilder input format at admin/settings/filters. Choose the filters 'Expand mapbuilder tags' (weight 2) and 'HTML filter' (weight 1), and - optionally the 'Line break converter'. - Configure the filter and add the '' tag to the Allowed HTML tags. + optionally the 'Line break converter'. Configure the filter and add the + '' tag to the allowed HTML tags. + +11. At admin/user/access , enable mapbuilder access controls. -5) edit your access control for mapbuilder in admin/user/access. +Now, test the installation: -6) try to make a new page using the mapbuilder filter and content e.g. +12. Create a Map Configuration post at node/add/mapconfig . - mapbuilder/config/1 - - In this example, '1' represents the drupal node id of the mapconfig node. - Replace this value by the id of your own node. - - or - - - - The config path is relative to the drupal base_path. - E.g. - - - - - If a mapbuilder context node has been added, it can be used in a config - node using the relative path 'mapbuilder/context/'. - A mapbuilder config node can be used as 'mapbuilder/config/'. - - To try a file, e.g. sites/all/modules/mapbuilder/demo/config.xml. - Note that this file assumes that the base_path is '/drupal-5.0'. If it is - not, replace it by your own value. - - The defaultModelUrl and skinDir paths in a config file contain - the base_path because these are processed by Mapbuilder. +13. Pick a title (say, "Test config) + +14. Put a map tag into the body, making sure that the relative path matches your +installation as in step 7 above: + + sites/all/modules/mapbuilder/demo/config.xml + +WARNING: Currently, throws an error. + +15. Put the following code into the Model Url box, again making sure that +the relative path matches your installation as in step 7 above: + + sites/all/modules/mapbuilder/demo/demisWorldMap.xml + +16. Press Submit. Your map should display. + +There can be a one-to-many relation between one config node and many posts. Here +is how to create one. + +17. Note down the node number for the config post (for example, "16). (If you + do not have clean URLs turned on, you can get the node number from the + URL of the config post. Otherwise, you can get the node number from + the "devel load" tab, if you have developer tools installed.) + +18. Create (for example) a blog entry. + +19. Give the post a title (say, "Post test") + +20. Put a map tag into the body (the example uses node ID "16" from step 16). + + mapbuilder/config/16 + +21. Under input format, select mapbuilder (see step 10). + +22. Press Submit. Your map should display.