CartoGraf is an interactive web-based mapping application to enhance learning in history and geography classes in high schools. CartoGraf is mainly based on Maps, Drawings, PluginAppFrame and Trackers. It is a great example of how to use profiles in a general purpose app to make a very specific application using Tiki as a Framework.
Development notice
When you apply the profile, you may see "Preference set: geo_tilesets=Array" in the response. This is a cosmetic error. The preference is set correctly.
To get your own copy of CartoGraf:
You need to get branches/15x (Tiki 15.x version from SVN) for the latest and greatest goodies :-)
Activate .htaccess by renaming _htaccess (even better is to link from .htaccess to _htaccess)
Note: rewrite rules are essential for this profile
You need to get the CartoGraf theme first and copy it over to the themes/ directory (see Theme section below)
Select and apply the CartoGraf-15 profile from tiki-admin.php?page=profiles
instructions: Setup
preferences:
feature_search_fulltext: n
feature_search: y
feature_sefurl: y
allowRegister: y
browsertitle: CartoGraf Demo
tracker_refresh_itemlink_detail: y
geo_always_load_openlayers: y
url_after_validation: Account_Validated
feature_jquery_ui_theme: start
feature_left_column: n
tracker_clone_item: y
toolbar_trackers: bold,list,numlist,wikiplugin_youtube
layout_add_body_group_class: y
feature_wiki_ext_icon: n
feature_syntax_highlighter: n
sitelogo_title: CartoGraf
sitelogo_alt: CartoGraf logo
Temporary
YAML
preferences:
validateUsers: n
feature_antibot: n
sitelogo_alt: CartoGraf logo
File Galleries Prefs
YAML
preferences:
fgal_tracker_existing_search: y
fgal_elfinder_feature: y
fgal_upload_from_source: y
fgal_quota_per_fgal: y
fgal_quota_default: 0
fgal_sort_mode: lastModif
fgal_list_name: n
fgal_list_description: y
fgal_list_last_user: y
fgal_list_author: o
fgal_list_created: o
fgal_list_lastModif: y
fgal_list_size: y
fgal_list_files: n
fgal_image_max_size_x: 800
User Files
YAML
preferences:
feature_userfiles: y
feature_use_fgal_for_user_files: y
userfiles_private: n
userfiles_hidden: y
userfiles_quota: 30
quota_show: bar_and_text
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.
As of Tiki 12 the default unified search engine uses mysql which has a minimum searchable token length of 4, so setting minumum user name length to 5 to be safe.
YAML
preferences:
username_pattern: /^[_a-zA-Z0-9]*$/
login_is_email: n
min_username_length: 5
preferences:
theme: CartoGraf
feature_fixed_width: n
jquery_ui_selectmenu: y
feature_page_title: n
feature_sitelogo: y
wiki_edit_plugin: n
sitelogo_src: themes/CartoGraf/img/logo.gif
smarty_security_dirs: [themes/CartoGraf/img]
Menus
YAML
objects:
-
type: menu
ref: CartoGraf_Top_menu
data:
name: Top
description: A menu containing the base navigation of the site
collapse: none
items:
-
name: Home
url: ((HomePage))
-
name: Help
url: ((Help))
-
name: Setup
url: ((Setup))
permissions: [ admin ]
-
type: menu
ref: CartoGraf_RightEdge_menu
data:
name: RightEdge
description:
collapse: none
items:
-
name: Register
url: tiki-register.php
-
name: Demo
url: ((Demo))
-
name: Contact
url: ((Contact))
Modules
YAML
preferences:
modseparateanon: y
objects:
-
type: module
ref: LiveHeaderMap_module
data:
position: top
order: 0
name: LiveHeaderMap
groups: [ Anonymous, Registered ]
params:
nobox: y
nopage: Map
custom: <div id="TheLiveHeaderMap" style="height:188px"></div>
-
type: module
ref: Footer_module
data:
position: bottom
order: 0
name: Footer
groups: [ Anonymous, Registered ]
params:
nobox: y
custom: "{if $prefs.language eq 'fr'}{wikiplugin _name='include' page='Footer' start='-FR-START-' stop='-FR-END-'}{/wikiplugin}{else}{wikiplugin _name='include' page='Footer' start='-EN-START-' stop='-EN-END-'}{/wikiplugin}{/if}"
-
type: module
ref: LocationSearch_module
data:
position: top
order: 49 #ensure the map location search is assigned as last module
name: map_search_location
groups: [ Registered ]
params:
legacy_mode: search_box
show_search_button: y
show_go_button: n
show_edit_button: n
default_button: search
page: Map
nobox: y
style: "float: right; margin-right: 15px" #most of the params ignored as the module is not standard and does have no module div rendered but just the form tag (TODO: fix in Tiki)
-
type: module
ref: TopMenu_module
data:
position: top
order: 1
name: menu
groups: [ Anonymous, Registered ]
params:
id: $CartoGraf_Top_menu
type:horiz
css:y
menu_id:TopMenu
translate:y
nobox:y
decorations:n
notitle:y
style: "float: left; margin-left: 350px"
-
type: module
ref: RightEdgeMenu_module
data:
position: right
order: 1
name: menu
groups: [ Anonymous ]
params:
bootstrap: n
id: $CartoGraf_RightEdge_menu
menu_id: RightEdgeMenu
nobox: y
nopage: Map
Features
YAML
preferences:
feature_wiki: y
feature_articles: n
feature_mytiki: n
feature_trackers: y
geo_tilesets: [openstreetmap, google_street, google_satellite, google_physical, google_hybrid, blank]
geo_google_streetview: y
geo_google_streetview_overlay: y
wikiplugin_appframe: y
wikiplugin_list: y
feature_search: y
feature_wiki_argvariable: y
trackerfield_geographicfeature: y
objects:
-
type: file_gallery
ref: iconContainer
data:
parent: 1
name: Icons
description: Icons available for selection in the map.
owner: admin
archives: 5
flags: []
init_files:
- https://profiles.tiki.org/pics/icons/plugin.png
-
type: file_gallery
ref: imageBank
data:
parent: 1
name: Image Bank
description: Images uploaded by site admins, for use by teachers and students
owner: admin
archives: -1
flags: [visible]
image_max_size_x: 0
__CartoGraf__ is an interactive web-based mapping application to enhance learning in history and geography classes in high schools. CartoGraf is mainly based on [https://doc.tiki.org/Maps|Maps], [https://doc.tiki.org/Drawings|Drawings], [https://doc.tiki.org/PluginAppFrame|PluginAppFrame] and [https://doc.tiki.org/Trackers|Trackers]. It is a great example of how to use profiles in a general purpose app to make a very specific application using Tiki as a ((dev:Framework)).
__CartoGraf__ is an interactive web-based mapping application to enhance learning in history and geography classes in high schools. CartoGraf is mainly based on [https://doc.tiki.org/Maps|Maps], [https://doc.tiki.org/Drawings|Drawings], [https://doc.tiki.org/PluginAppFrame|PluginAppFrame] and [https://doc.tiki.org/Trackers|Trackers]. It is a great example of how to use profiles in a general purpose app to make a very specific application using Tiki as a ((dev:Framework)).
-
{REMARKSBOX(type="information" title="Development notice" icon="bricks" close="y" width="80%")}When you apply the profile, you may see "Preference set: geo_tilesets=Array" in the response. This is a cosmetic error. The preference is set correctly.
-
{REMARKSBOX}
To get your own copy of CartoGraf:
To get your own copy of CartoGraf:
Lines: 12-16
Lines: 9-13
# Activate .htaccess by renaming _htaccess (even better is to link from .htaccess to _htaccess) {REMARKSBOX()}Note: rewrite rules are essential for this profile{REMARKSBOX}
# Activate .htaccess by renaming _htaccess (even better is to link from .htaccess to _htaccess) {REMARKSBOX()}Note: rewrite rules are essential for this profile{REMARKSBOX}
# You need to get the CartoGraf theme first and copy it over to the -+themes/+- directory (see Theme section below)
# You need to get the CartoGraf theme first and copy it over to the -+themes/+- directory (see Theme section below)
-
# Select and apply the CartoGraf-15 profile from tiki-admin.php?page=profiles
+
# Select and apply this __CartoGraf_15__ profile from tiki-admin.php?page=profiles
# Follow the ((CartoGraf_15_Setup|profile Setup instructions))
# Follow the ((CartoGraf_15_Setup|profile Setup instructions))
options: galleryId: 2 filter: image/* count: 1 displayMode: img replace: n uploadInModal: y image_x: 800 image_y: 800
tracker: $pointsOfInterest
tracker: $pointsOfInterest
flags: [ public ]
flags: [ public ]
Lines: 451-455
Lines: 479-488
name: Description
name: Description
type: text_area
type: text_area
-
options: "1,,12"
+
options: toolbars: 1 height: 6 distinct: n wysiwyg: n samerow: 1
tracker: $zones
tracker: $zones
flags: [ public ]
flags: [ public ]
Lines: 559-563
Lines: 592-601
name: Instructions
name: Instructions
type: text_area
type: text_area
-
options: "1,,15"
+
options: toolbars: 1 height: 6 distinct: n wysiwyg: n samerow: 1
tracker: $maps
tracker: $maps
order: 20
order: 20
Lines: 571-575
Lines: 609-613
tracker: $maps
tracker: $maps
flags: [ public, list, searchable ]
flags: [ public, list, searchable ]
-
options: "0,10,,,50
+
options: "0,10,,,50"
order: 30
order: 30
permname: shareCode
permname: shareCode
Lines: 675-679
Lines: 713-717
!! File Galleries
!! File Galleries
-
User files needs to be added somewhere
+
User files need to be added somewhere
{CODE(caption=YAML)}
{CODE(caption=YAML)}
objects:
objects:
Lines: 792-798
Lines: 830-842
content: wikicontent:CartoGraf_MapSelector
content: wikicontent:CartoGraf_MapSelector
{CODE}
{CODE}
+
! Known Issues
+
!! Regressions
+
(means it works fine in Tiki 12)
+
* Streetview images loaded remotely from Google after saving the marker do not load (403 forbidden even with API key filled in to control panels - seems missing lib reference in html head for some reason?)
+
* --Uploading files (images) via modal dialog does not work (returns error "File empty") ( see https://dev.tiki.org/item6350 )-- Workaround-ed by setting the height max size too.
! Notes
! Notes
-
* [https://tiki.org/TikiFestMontreal-Ottawa11#Maps_REAL_AMP_CartoGraf|CartoGraf was originally and officially launched on 2013-04-13 during the TikiFest Montréal/Ottawa in 2013] and is in production at https://cartograf.recitus.qc.ca/ (This site is in French) and at [https://cartograf.learnquebec.ca] (in English)
+
* [https://tiki.org/TikiFestMontreal-Ottawa11#Maps_REAL_AMP_CartoGraf|CartoGraf was originally and officially launched on 2013-04-13 during the TikiFest Montréal/Ottawa in 2013] and is in production at http://cartograf.recitus.qc.ca/ (This site is in French) and at [https://cartograf.learnquebec.ca] (in English)