Instructions

Thank you for deploying the CartoGraf Profile for Tiki 15.x+!
Please make sure you have applied this on Tiki 15 or newer version.

Here are the next steps:
  1. If you haven't done so already (and you see "broken theme" layout): Get the latest snapshot of the CartoGraf theme from SVN using the svn checkout https://svn.code.sf.net/p/tikiwiki/code/users/cartograf cartograf command (you can also download the version which is attached to the bottom of https://profiles.tiki.org/CartoGraf_15 but that may be outdated) and copy the themes/ folder over to your Tiki root folder (it should place everything into the themes/CartoGraf/ dir).
  2. For the location search field in the maps to work properly you need to generate Google API key on https://console.developers.google.com/apis/credentials first and then enter it on tiki-admin.php?page=maps where it says "You need to set Google Maps API Key" warning.
  3. Upload in the File Gallery (in the "Icons" gallery folder) some icons that can be used as markers on the maps. A great source is: https://mapicons.mapsmarker.com/. You can upload a zipped file and ask Tiki to unzip the files.
    • If you create children file galleries, they will appear as such when picking a marker
  4. Upload in the File Gallery (in the "Image bank" gallery folder) some images that can be used for points of interests of zones. A great source is: https://commons.wikimedia.org/wiki/Category:Images. You can upload a zipped file and ask Tiki to unzip the files.
  5. Set a password for the demo user and update the Demo page to make it easy for new users to see how things work
  6. Set the sender email
  7. Update the Contact page so visitors can get in touch with you with questions
  8. Update the top and right-hand menus here
  9. If you want to add/remove colors in the legend, add them to the code at MapCanvasSolo and MapCanvasShare.
    • You should also add a file of the same color in the "Icons" gallery folder.
  10. If you expect your site to host a large number of files, you may want to set the File Gallery storage to the file system (instead of the default database storage)
  11. Go and create your custom language files as described at https://profiles.tiki.org/CartoGraf_languages This is to override generic Tiki labels by things which are more specific and make sense for CartoGraf
  12. You can change the "Available tile layers on maps" here
  13. Enjoy


Troubleshooting


Limitations

Limit username pattern

CartoGraf relies heavily on Unified Search (Zend_Search_Lucene). Because of this, a username jean-marc won't work. Since hypens are often used in emails, you can't use CartoGraf with the pref "Use email as username" (login_is_email). Space and quote should also not be permitted. Theoretically, underscore (_) should work, but tests have demonstrated that is doesn't. Thus, we are restricting to only numbers and letters, without any accents.

One single language

CartoGraf can be deployed in any language but your instance can't support more than 1 language at once. It was originally developed for English or French. For another language, check the differences between the two profiles and extrapolate

Admin panel quirk

  • After a rebuild tiki-admin.php?page=search&rebuild=now you can't scroll just on that page even if no map. Cause: Looks like rebuild includes all the js generated by every object in the page that comes back - needs to cache & restore header lib after rebuild


Developer notes

1-liner to re-install a fresh Tiki with profile in English
php console.php database:install --force; php console.php profile:apply CartoGraf_15; php console.php index:rebuild; php console.php c:c


You may get simmilar PHP notices which can be ignored (The important is the last line "Profile applied"):
PHP Notice: Array to string conversion in /var/www/clients/client1/web16/subdirs/tiki15x-cartograf/lib/core/Tiki/Profile/Installer.php on line 496 PHP Notice: Array to string conversion in /var/www/clients/client1/web16/subdirs/tiki15x-cartograf/lib/core/Tiki/Profile/Installer.php on line 496 PHP Notice: Undefined index: use_items_icons in /var/www/clients/client1/web16/subdirs/tiki15x-cartograf/lib/core/Tiki/Profile/InstallHandler/Menu.php on line 130 PHP Notice: Undefined index: parse in /var/www/clients/client1/web16/subdirs/tiki15x-cartograf/lib/core/Tiki/Profile/InstallHandler/Menu.php on line 133 PHP Strict Standards: Only variables should be passed by reference in /var/www/clients/client1/web16/subdirs/tiki15x-cartograf/lib/core/Tiki/Profile/InstallHandler/Menu.php on line 139 PHP Notice: Undefined index: icon in /var/www/clients/client1/web16/subdirs/tiki15x-cartograf/lib/core/Tiki/Profile/InstallHandler/Menu.php on line 142 PHP Notice: Undefined index: icon in /var/www/clients/client1/web16/subdirs/tiki15x-cartograf/lib/core/Tiki/Profile/InstallHandler/Menu.php on line 142 PHP Notice: Undefined index: icon in /var/www/clients/client1/web16/subdirs/tiki15x-cartograf/lib/core/Tiki/Profile/InstallHandler/Menu.php on line 142 PHP Notice: Undefined index: position in /var/www/clients/client1/web16/subdirs/tiki15x-cartograf/lib/core/Tiki/Profile/InstallHandler/Menu.php on line 153 PHP Notice: Undefined index: use_items_icons in /var/www/clients/client1/web16/subdirs/tiki15x-cartograf/lib/core/Tiki/Profile/InstallHandler/Menu.php on line 130 PHP Notice: Undefined index: parse in /var/www/clients/client1/web16/subdirs/tiki15x-cartograf/lib/core/Tiki/Profile/InstallHandler/Menu.php on line 133 PHP Strict Standards: Only variables should be passed by reference in /var/www/clients/client1/web16/subdirs/tiki15x-cartograf/lib/core/Tiki/Profile/InstallHandler/Menu.php on line 139 PHP Notice: Undefined index: icon in /var/www/clients/client1/web16/subdirs/tiki15x-cartograf/lib/core/Tiki/Profile/InstallHandler/Menu.php on line 142 PHP Notice: Undefined index: icon in /var/www/clients/client1/web16/subdirs/tiki15x-cartograf/lib/core/Tiki/Profile/InstallHandler/Menu.php on line 142 PHP Notice: Undefined index: icon in /var/www/clients/client1/web16/subdirs/tiki15x-cartograf/lib/core/Tiki/Profile/InstallHandler/Menu.php on line 142 PHP Notice: Undefined index: position in /var/www/clients/client1/web16/subdirs/tiki15x-cartograf/lib/core/Tiki/Profile/InstallHandler/Menu.php on line 153 PHP Warning: preg_match() expects parameter 2 to be string, object given in /var/www/clients/client1/web16/subdirs/tiki15x-cartograf/lib/filegals/filegallib.php on line 3941 Profile applied.


Aliases
CartoGraf-15_Setup