Export Profiles tab

1.1. Using Tiki user interface

1.1.1. Preferences in Control Panel 'Profiles'

Overview: Use this tab to create a new profile by exporting your site's current configuration

To Access: From the Profiles Admin page, click the Exports tab.

Note: Refer to http://profiles.tiki.org for details on extending the exported YAML

Export tab

Setting	Description	Default
Object Type	Select the Tiki objects from the existing site to export	Preferences
Export modified preferences as YAML	Use this section to filter or select specific objects to export ot YAML

1.1.2. Tracker definitions and tracker fields

You can do so in Tracker Export and select the last option to export as yaml code for tiki profiles.

1.2. Using command line tools (php console.php)

Available from Tiki12. Unlike the earlier tools to export as profiles, the command line tools, such as Console, cover the entire workflow of profile creation and perform better reference tracking between objects, allowing to create profiles that are more complete out of the box.

These early screencasts explain how the process works. The program tiki in the first video is a shortcut for php console.php in Tiki's root.

Something might be wrong with the second video and you can see a green screen only.

1.2.1. Overview of profile:export

Process overview:

php console.php profile:export:init Some_Profile_Name
- Create a blank profile
php console.php profile:export:recent-changes --since "2 week ago"
- Note: Use a timespan appropriate to the duration of your work
  This command reports the changes found, but does not export those changes to the new .wiki files yet.
php console.php profile:export:tracker, php console.php profile:export:wiki-page, ... to include objects in your profile
- If you repeat the recent changes step, objects you added will be removed from the list
php console.php profile:export:finalize
- If some references are unresolved, suggestions will be proposed, including adding references to previously installed profiles.

If you are within a MultiTiki instance, you need to append the extra param --site=site1.example.com, so that tiki knows which tiki should search the objects in (site1.example.com in this example), among all the instances within the same multitiki installation (site2.example.com, site3.foo, site4.bar, ...).

1.2.2. Exportable tiki objects

Copy to clipboard

profile:export:activity-rule-set
profile:export:activity-stream-rule   
profile:export:all-modules
profile:export:article    
profile:export:article-topic    
profile:export:article-type     
profile:export:category   
profile:export:file-gallery     
profile:export:forum
profile:export:goal 
profile:export:goal-set   
profile:export:group
profile:export:include-profile  
profile:export:menu 
profile:export:module     
profile:export:preference 
profile:export:rating-config    
profile:export:rating-config-set
profile:export:recent-changes   
profile:export:rss  
profile:export:tracker    
profile:export:tracker-field
profile:export:tracker-item
profile:export:wiki-page

Some new options added in Tiki18: files get exported also.

Copy to clipboard

php console.php profile:export:file-gallery --include-files 4

Also added in Tiki18: export of tracker items

Example to copy fields + items from trackerId 1

Copy to clipboard

php console.php profile:export:tracker-item --reference name 1

Example to copy the field 2 from item 1 in trackerId 1

Copy to clipboard

php console.php profile:export:tracker-item --items 1 --fields 2 --reference name 1

1.2.3. Export of tracker items

Since Tiki18 it is also possible to export tracker items, defining one tracker and filter a list of items (optional) and a list of fields (optional).

1.2.4. How to apply the local profile elsewhere

If you want to install this profile elsewhere, copy the local profile (usually from folder ./profiles), place it at the new server or new tikiroot path, and execute in the terminal at the tikiroot path:

Command

Copy to clipboard

php console.php profile:apply Some_Profile_Name file://profiles

Tip: in Windows OS you also need to use this syntax "file://profiles" (and not "file:\\profiles").

See Local profiles

1.2.5. Examples

Profile creation that include an empty tracker and wiki pages.

Using the following will create a profile with the tracker Id 1 (empty from items) and the 2 Wiki pages (homepage and contact-)

Profile creation

Copy to clipboard

php console.php profile:export:init Contacts
php console.php profile:export:tracker --reference name 1
php console.php profile:export:wiki-page homepage
php console.php profile:export:wiki-page contact-
php console.php profile:export:finalize

To apply this profile on a different tiki, you have to copy the profile folder ("Contacts" in that example) from within the "profiles" directory from your Tiki source (where you created the profile) and to place it in the "profiles" folder of your Tiki destination.

Once it is done (and permission set according to your setup) use the following command to apply it.

Profile installation + re-indexing

Copy to clipboard

php console.php profile:apply Contacts file://profiles
php console.php i:r

Profile creation that include a tracker, the tracker items and a wiki page.

Using the following will create a profile with the tracker Id 1 with all the items plus one Wiki pages (homepage)

Profile creation

Copy to clipboard

php console.php profile:export:init Contacts
php console.php profile:export:tracker --reference name 1
php console.php profile:export:tracker-item 1
php console.php profile:export:wiki-page homepage
php console.php profile:export:finalize

Once it is done (and permission set according to your setup) use the following command to apply it.

Profile installation + re-indexing

Copy to clipboard

php console.php profile:apply Contacts file://profiles
php console.php i:r

1.2.6. Advanced usage

In some cases, you may have used some custom jquery code in wiki pages or in tracker fields of type 'static text', with hardcoded references to tracker ids, tracker field ids, or category ids, and those numbers are not renamed by default to the corresponding profile reference for that tiki object, since that a complex case to handle properly. A compromise for such cases has been added so that if you add some extra comment at the end of the line indicating that the preceding line has some value to be replaced by the corresponding profile reference, Tiki will do so for you.

That means that the profile exporter will catch the lines within jquery code in which the user has added a specific comment as a flag for tiki to do a replacement there in these three cases:

Copy to clipboard

javascript-code // profile_reference=tracker
javascript-code // profile_reference=tracker_field
javascript-code // profile_reference=category

Examples:

Copy to clipboard

trackerId: 13, // profile_reference=tracker
var user_fields = ['230', '302', '303']; // profile_reference=tracker_field
$("select[name='ins_160[]']").val("26").trigger('chosen:updated').parents(".form-group").hide(); // profile_reference=category

In fact, we support any profile reference already implemented such as wiki_page (other than just tracker, tracker_field and category). The full list is in lib/core/Tiki/Profile/InstallHandler dir, which is documented online also here:
https://profiles.tiki.org/Handlers

alias