History: Tiki15from12
Source of version: 11 (current)
Copy to clipboard
! Tiki15 from Tiki12
__This page summarizes all the changes you may find when you upgrade from ((Tiki12)) 'Long Term Support' (LTS) to ((Tiki15)) LTS__. You may also read the partial changes in each version ((Tiki13)), ((Tiki14)) & ((Tiki15)).
* Tiki15.0 was released in April 2016.
* As it is a Long Term Support (LTS) version, it will be supported for 5 years, and ((Requirements|requires PHP 5.5)). See ((info:version lifecycle)).
* It uses Bootstrap CSS framework.
* More information: at the development page https://dev.tiki.org/Tiki15
{maketoc title="" levels="2,3"}
!!# Action log extended
Creating, modifiying or deleting __calendar events__ can also be recorded and displayed through the ((Action log)), since version 15.1.
!!# "Admin home": renamed to "Control Panels"
The page where you can access the main settings for all features was traditionally called "__Admin home__". In order to prevent confusions for the new admins with the page to administer a single feature, "Admin home" was renamed to "__Control Panels__".
This way, and as example, the page to manage the settings for all forums in Tiki is called "Forums control Panel" (tiki-admin.php?page=forums), while the page to modifiy a specific forum, keeps the name "Admin Forums" (tiki-admin_forums.php)
!!# Addons
Addons is a way of packaging ((Profiles)), ((Smarty Templates)) and other building blocks of application functionality that can be used to better manage different Tiki configurations by developers and also for developers to offer these as independently maintained "apps" to others. See: ((Addons))
!!# Advanced Rating
Some new functions have been added since Tiki 14.0: __Not__, __IsEmpty__, __date__, __less-than__, __more-than__ and __contains__.
See ((Advanced Rating))
!!# Articles improved
* Added the ability to grab the content of an article from URL, and store it in articles. http://sourceforge.net/p/tikiwiki/code/50743/
* Article can be attached to a tracker item http://sourceforge.net/p/tikiwiki/code/50708/
* Adding basic option to fetch the content from source when using article generator instead of relying on the excerpt from the feed http://sourceforge.net/p/tikiwiki/code/49059/
!!# AutoTOC mini-revamp
The AutoTOC feature has been updated to use [http://getbootstrap.com/javascript/#scrollspy|Bootstrap ScrollSpy] - normal server-side maketoc one to come (hopefully also for 15.0)
(Several commits leading up to [http://sourceforge.net/p/tikiwiki/code/57161|r57161])
!!# Banning multiple registration IPs from user management
Admins can easily ban multiple IPs from spam registrations directly with just a few clicks. They can also optionally remove the user accounts and their user tracker items, as well as their user pages.
See ((Users))
!!# Bootstrap
* ((themes:Bootstrap))
See also [#Themes] below.
!!# Console
Usual management tasks done through a console are now handled by a common console.php script with many paramters.
* DB Redactor added . http://sourceforge.net/p/tikiwiki/code/47589/
* Allow refreshing of incoming RSS feeds through console. http://sourceforge.net/p/tikiwiki/code/51073/
* ((Mail queue)) (through zend stmp) fixed.
See ((Console))
!!# Content templates can be categorised and locked
From the Tiki15 release Content templates can be categorised so that access to individual templates can be restricted to designated Groups.
Content templates can also be 'locked' from Tiki 15 onwards, in a similar way to individual wiki pages, so that even when Categorisation is used to restrict access to a Group, editing of a Content template can be restricted further to the individual user that locks it. A new preference needs to be set to allow this locking option to be available and a new permission has been created to allow individual users the privilege to do it. As with all the various permissions 'sets', if a user has been granted tiki_p_admin_content_templates they can do all the various content template activities including the unlocking of a template locked by another user.
Content templates are a good way to ensure new content is created with a consistent layout and style especially when a Tiki system has multiple editors, and it also provides a fast way to set up complex new content with initial 'starting' data - see ((Content templates)) for more details. The categorisation and locking functions then provide a range of options to allow groups/individuals to control how they are updated.
!!# Custom LESS preference
New preference textarea on control-panels/look & feel/customisation where you can add LESS definitions that then recompiles a new version of the currently selected theme and option using definitions declared there.
(Mostly added in [http://sourceforge.net/p/tikiwiki/code/56867|r56867] but with subsequent fixes to r57047 so far)
Some minimal documentation and one example (so far) can be found here: ((themes:Custom Less))
!!#Customise mail templates using a simple 'preference' setting
The format/style of the various automated email notifications are set using smarty templates held in the templates/mail/ folder and it has always been possible to make customised copies of these and store them in the template area of your theme/style. In this way they are only invoked when your theme is used and they are not overwritten when the site is upgraded. But this can cause a significant maintenance overhead since new templates are added from time to time and existing ones are improved or updated to fix bugs, so any customised copies have to be continually updated.
From Tiki15 however a simple text preference setting has been introduced where a short text string can be stored - which is set in the "General Settings" tab of the "Editing and Plugins" admin screen - where the text would typically be a description of your site. A reference to this stored text has been added to all the mail templates in appropriate places so that a very simple customisation of the existing 'vanilla' templates is then automatically produced and mail notifications can be made to be much easier to understand, especially if you are involved with multiple Tiki sites. It should be noted that the default value of the customising text string is an empty string so that if it not set it has no effect on the output of the standard template text - but a consequence of this is that if a customised text is set then it should have a blank character at the end of the text so that its insertion scans properly.
!!# Federated Search
((Federated Search))
!!# File Gallery Batch Upload Improvements
Some general improvements and new options to organise files according to subdirectories and create missing ones, also to file by gallery ID.
Including new console commands files:batchupload and files:deleteold to enable scheduled tasks to be set up for automatic gallery maintenance.
More info here ((Batch Upload))
!!# File Gallery Upload Improvements
New preference to enable a new [https://blueimp.github.io/jQuery-File-Upload|jQuery File Upload] interface allowing drag and drop, multiple file uploads, progress bars etc.
!!# Frontpage can be created in html
The Tiki front page can be created in HTML format, if wysiwyg HTML mode is selected. This enables full inline editing of front page. http://sourceforge.net/p/tikiwiki/code/47565/
!!# Goals
See ((Goals)) and ((Tutorial: Goals))
!!# Installation faster
The installation is faster than before. There is a batch of insert tiki_secdb during installation, if a mysql_data file exists and the user has a mysql file permission. http://sourceforge.net/p/tikiwiki/code/50986/
!!# Jitsi
Added configuration for jitsi provisioning http://sourceforge.net/p/tikiwiki/code/49699/
See ((Jitsi))
!!# Layouts
* Layout template for 3-6-3 column width configuration (25%, 50%, 25% widths) http://sourceforge.net/p/tikiwiki/code/49517/
* New layout for social sites with classic top navigation bar http://sourceforge.net/p/tikiwiki/code/49734/
!!# Look and Feel: custom LESS section
There is a new section under the ((Customization)) tab of the Look & Feel Control Panel which allows to set some base parameters for colors and other css properties, which will be applied to generate all properties for the Theme style of your choice.
Example:
{CODE(colors="css", ln="1")}
@brand-primary: #abb;
@gray-base: #431;
@navbar-inverse-bg: #797;
@navbar-default-bg: #cea;
{CODE}
See: ((Customization))
!!# Mail-in improved
Allow mail-in post comment on notification reply, fixed encoding issues, better reply-stripping for gmail http://sourceforge.net/p/tikiwiki/code/50660/
!!# Mobile-ready display
There is no need to apply profile ((pr:Mobile)) anymore on Tiki13.0, since it automatically adapts its display to mobile devices when needed.
!!# Modules
!!!# Module zone
New module meant to provide a module "navbar" for the website. You add a "zone", and then you can drop a module menu in it. The menu module creates the toggle button and internal nabbers.
See ((Module zone))
!!!# Module minichat
The date is shown for the messages from previous days to avoid confusing users.
See ((Module minichat))
!!# Multilike
This feature expands on the like functionality to allow users to provide more qualitative feedback to the system.
See ((Multilike))
!!# Must Reads
See ((Must Reads))
!!# Namespaces improved
Ability to force all non-namespace page links to same namespace of the page being edited http://sourceforge.net/p/tikiwiki/code/50755/
!!# Newsletters
Counters have now been added when sending Newsletters, which is useful when sending newsletters with a large subscriber list. It is also particularly useful when the option to 'throttle' the newsletter send rate is being used which is an option that may have to be used to avoid the sending system being 'designated' as a spammer and being blocked by receiving mail servers. When using the 'throttle' option, additional remarks are now provided to remind the user that this option is in use, and the send process has also been fixed so that the 'completion' notices and information are correctly displayed.
These additional Newsletter features have also been backported for the Tiki12.5 and Tiki14.2 releases.
!!# Notifications
Notifications have been revamped. See: ((Notifications)) and ((Tutorial: User Notifications))
!!# Payments improved
* Added payment gateway for Israel Post.
* Added method to be able to referance paypal by invoice id, and password and siganature from PayPal Pro account http://sourceforge.net/p/tikiwiki/code/49504/
See ((Payments))
!!# Profiles
!!!# Profile exporter improved
* Profile handlers (and export) for activity stream custom rules http://sourceforge.net/p/tikiwiki/code/47430/
* Group profile exporter http://sourceforge.net/p/tikiwiki/code/49606/
!!!# Hide Fixed Top Nav Bar on Scroll
If you choose in __'Look & Feel' Control Panel > Theme (tab) > Site layout__: "Fixed_top_modules", then you can apply this "scroll" (search for it) profile through the Profiles Control Panel and you will get your top zone hidden temporarily when you scroll down your site.
See profile: ((pr:Hide Fixed Top Nav Bar on Scroll))
!!!# Profiles Wizard
New profile [http://profiles.tiki.org/Revision+Approval+(ISO9001)|Revision Approval (ISO9001)] added to the Profiles Wizard, preconfigured to use also the new [#Wiki_Argument_Variables|Wiki Argument Variables] introduced in Tiki14 (see below) :
^{CENTER()}{img src="http://tiki.org/display615" width="400" height="420" desc="Click to enlarge" rel="box[g]"}{CENTER}^
See also ((Profiles Wizard))
!!# Remote Tiki Autologin
Users from another Tiki are allowed to login to this Tiki using their credentials there. This provides a quick way to create a sub-site or sister site.
See ((Remote Tiki Autologin))
!!# Removal of "Synchronize categories of user tracker item to user groups" feature
This feature has been removed in Tiki 15. The preferred way to achieve similar functionality is to use the ((User Groups)) field instead. For more information, see ((Synchronize categories of user tracker item to user groups)).
!!# Score
The points system was reworked in Tiki15. The main scoring events are still pre-configured for beginner users to be able to use, but the ability to add new scoring events was implemented as well for added flexibility.
See ((Score))
!!# SEFURL improved
Search Engine Friendly URL (SEFURL) for Calendar events added to route and upcoming_events module http://sourceforge.net/p/tikiwiki/code/49247/
!!# Server requirements
A few more packages are required to provide the required php extensions that this version of Tiki needs:
;php5-curl: CURL module for php5
;php5-intl:internationalisation module for php5
;php5.5-xml - DOM, SimpleXML, WDDX, XML, and XSL module for PHP
In Debian-based distributions, you can install then in a terminal on the server with this type of command:
{CODE(colors="shell")}
sudo apt-get install php5-curl php5-intl php-5.5-xml
{CODE}
Adapt to your case in other GNU/Linux distributions or operating systems at the server.
!!# SLUG
SLIG's are alternate urls designed for brevity, search engine friendliness, not changing over time, etc. Tiki 14 allows to change the URL scheme for wiki pages, currently to replace spaces with underscores.
For more information:
https://sourceforge.net/p/tikiwiki/code/51860
https://tiki.org/tiki-view_forum_thread.php?forumId=26&comments_parentId=52799
http://en.wikipedia.org/wiki/Slug_%28web_publishing%29
!!# Social Networks with Linkedin
You can also set up your site to allow users to log into LinkedIn as they can with Facebook.
See ((Social Networks))
!!# Stored Search Queries
* ((Stored Search)) using Elasticsearch's Percolator feature: http://www.elasticsearch.org/blog/percolator-redesign-blog-post/
!!#Structures can be locked
From Tiki 15 a wiki structure can be locked, meaning that the pages that are in a structure and the order/hiererchy of these pages can only be changed by the locking user.
A new preference needs to be set to allow this structure locking option to be available and a new permission has been created to allow individual users the privilege to do it. As with all the various permissions 'sets', if a user has been granted tiki_p_admin_structures (now added as a new permission) they can do all the various structure activities including the unlocking of a structure locked by another user.
To make structure permission management clearer and easier to find, a new 'wiki structure' section has been created in the permission tables.
For details of all these additions see the ((Structure User|Structure)) documentation page.
!!#Structure tools added to the top page and permissions 'tidy-up'
From Tiki15 tools for the top page have been added so that the range of structure admin functions can be carried out on the top page of the Structure as well the individual pages. See the [Structure+User#Editing_an_existing_structure|Structure editing] documentation for more details.
In addition what permissions are needed to carry out the various Actions on a Structure have been clarified and made more consistent. See the [Structure+User#Structure_permissions|Structure permissions] documentation for more details.
!!# Surveys improved
There have been a few improvements to surveys:
* Use sefurl for take_survey links
* Make questions (drag & drop) sortable on admin questions
* Allow control of the textarea toolbar per question, and add a "c" option to use the "comments" minimal toolbar
* Added options for header type - newpage triggers pagination mode and inserts a page "break", and tag allows setting of heading type (default is h3)
* ((Permissions|Object permissions)) used for take survey and view stats
* Allow showing of user's voted option in survey states
* Added a drop down selector for user to show icon next to responses in stats, and other minor fixes
{img src="display1082" link="display1082" width="400" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}
See ((Surveys))
!!# Tablesorter
The tablesorter usage has been extended to new features like:
* List of wiki pages (tiki-listpages.php),
* List of forums (tiki-forums.php),
* Topic list for a forum (tiki-view_forum.php),
* Forums Administration (tiki-admin_forums.php)
See ((Tablesorter))
!!# Temporary User Accounts
Temporary users cannot login the usual way but instead do so via an autologin URL that is associated with a ((Token)). These temporary users will be deleted (but can be set to be preserved in Admin Tokens) once the validity period is over. Normally, these users should have read-only access. Nevertheless, if you are allowing these users to submit information, e.g. fill in a tracker form, make sure to ask for their information again in those forms. You can use this feature through:
__Admin Users > Temporary Users (tab)__
(Related commit: r56888)
!!# Terms and Conditions improved
* Added terms and conditions feature to manage terms page and make sure users approved the latest approved terms before accessing the site http://sourceforge.net/p/tikiwiki/code/49418/
* Added age validation prior to user conditions http://sourceforge.net/p/tikiwiki/code/49483/
!!# Themes
!!# Themes
File design.css has been renamed to tiki.css.
Some style themes have been converted to [#Bootstrap] (maybe at different degrees of completion at the time of this writing):
* Fivealive
* Jgui
* TheNews
And some new Themes have been added:
* Bootswatch themes. See bootswatch.com for more information (r50408, r50790)
** Amelia
** Cerulean
** Cupid
** Darkly
** Lumen
** Shamrock
** Superhero
** Yeti
** ...''and many more''
|| ::Some Bootswatch themes incorporated::
{img src="display1085" link="display1085" width="150" rel="box[g]" imalign="center" desc="Amelia - Click to expand" align="center" styleimage="border"} | {img src="display1086" link="display1086" width="150" rel="box[g]" imalign="center" desc="Cupid - Click to expand" align="center" styleimage="border"} | {img src="display1087" link="display1087" width="150" rel="box[g]" imalign="center" desc="Shamrock - Click to expand" align="center" styleimage="border"} | {img src="display1088" link="display1088" width="150" rel="box[g]" imalign="center" desc="Yeti - Click to expand" align="center" styleimage="border"}
||
To use them (for instance, "cerulean"), you can select them at the panel __Admin home > Look and Feel__:
* Theme selection: __Bootstrap themes in the "styles" directory__
* Theme: __bootswatch_themes__
* Theme options: __cerulean__
!!!# Theme refactoring
In addition, there has been some refactoring in the way to handle theme styles. See:
* https://themes.tiki.org/Concept+and+Design
* https://themes.tiki.org/How+To+Add+a+New+Theme
In short, you can define colors in variables, in apply those variables to other css selectors. See:
http://themes.tiki.org/Using+the+Less+CSS+pre-processor+with+Tiki
In addition, if you use the ((Newsletters)) feature, please note that placement of the newsletter.css has changed with the new bootstrap theme architecture. Since Tiki version 14, the customised __newsletter.css__ file should be placed in either one of the next folders:
* -+/themes/yourtheme/css/+-
* -+/themes/yourtheme/options/youroption/css/+-
!!!# Icon sets
The reason for having different iconsets is the same as for having different themes, users are given the freedom to choose whichever they like and to customize/create new ones if they dont like what is shipped with Tiki.
There are differents sets of icons available in the Look&Feel control panel.
{img src="display1248" link="display1248" width="400" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}
Options:
- __Default (Font-awesome):__ The default system icon set using Font-awesome, see http://fortawesome.github.io/Font-Awesome/icons/
- __Glyphicons :__ Glyphicon focused iconset, see http://getbootstrap.com/components/
- __Legacy (pre Tiki14) icons:__ Legacy (pre Tiki14) icons, mainly using famfamfam images, see http://www.famfamfam.com/lab/icons/silk/
- __Icons of the displayed theme:__ This option is for advanced administrators. Icon sets are applied for all themes, except when the setting "Icons of the displayed theme" is applied. In this case the theme is displayed always using the icon set defined for that theme (eg: defined in /themes/mytheme/icons/mytheme.php)
More information:
* https://themes.tiki.org/Icons
* http://dev.tiki.org/Icons
* http://dev.tiki.org/Tiki14#Icon_Sets
!!# Time Ago Date Formatting
Optional ''fuzzy'' date formatting throughout Tiki, such as "Last modified 5 minutes ago" or "Created 2 months ago" etc.
Added in [http://sourceforge.net/p/tikiwiki/code/57081|r57081]
!!# Trackers
Trackers improved in a few places:
* Added an articles field type, allowing to attach articles to a tracker item. http://sourceforge.net/p/tikiwiki/code/50708
* Allow creating of associated tracker item for article. http://sourceforge.net/p/tikiwiki/code/51203/
* Ability to link wiki pages to tracker items (not just through page field but through text fields) and associated functionality http://sourceforge.net/p/tikiwiki/code/50769/
In addition:
!!!# Service_inline to display info from linked trackers
When using linked trackers with fields "item link/items list", if you use custom smarty templates, you might be able to include some view of the other tracker using {service_inline} and likely a custom tracker item template file. See [http://tiki.org/tiki-view_forum_thread.php?comments_parentId=54344|more information].
!!!# Tracker Tabular
A new system to import / export tracker data, called "((Tracker Tabular))", has been implemented.
!!!# Tracker Field 'Computed' extended
Three new options have been added to the display of the Computed tracker field, in a similar fashion to the existing options in the numeric field:
* Decimal Places:
+ Amount of decimals to preserve before rounding.
* Decimal separator when displaying data:
+ Single character. Use c for comma, d for dot or s for space. The valid decimal separator when inserting numbers may depend on site language and web browser. See documentation for more details.
* Thousand separator when displaying data
+ Single character, Use c for comma, d for dot or s for space. When inserting data no thousands separator is needed.
See: ((Computed Tracker Field))
!!!# Tracker Field 'Mathematical Calculation' extended
Some new operators and functions are added to the advanced rating language in Tiki 14.x, which can be used in trackers through the ((Mathematical Calculation Tracker Field))
See [#Advanced_Rating]
!!# Unified index improvements
Some extra information have been exposed at the ((Unified Index)) for the features than take profit of it like the ((Stored Search)) and similar:
*__hits__
*__lastpost_title__
*__lastpost_modification_date__
*__lastpost_contributors__
*__lastpost_post_content__
*__lastpost_post_snippet__
*__lastpost_hits__
*__lastpost_thread_id__
!!# User Encryption
See ((User Encryption))
!!# Validation syntax
Validation (in tracker fields and other areas of Tiki where some validation rules can be defined) require no more escaping of backslashes. Thus, this former regular expression worked in Tiki 12 LTS:
{CODE(caption="Regular expression for positive numbers in 12.x")}
^[0]{1}$|^(?!0*[.,]0*$|[.,]0*$|0*$)\\d+[,.]?\\d{0,2}$
{CODE}
...but it needs to be converted for 14.x into:
{CODE(caption="Regular expression for positive numbers in 14.x")}
^[0]{1}$|^(?!0*[.,]0*$|[.,]0*$|0*$)\d+[,.]?\d{0,2}$
{CODE}
See ((Regexps|Regular Expressions))
!!# ViewerJS
Support has been added for [http://viewerjs.org|ViewerJS], which will allow your site to easily display embedded PDF documents, as well as presentations, spreadsheets and other documents without any external dependencies. This external library needs separate installation in Tiki (it cannot be included by default due to licensing issues, but it is fairly easy to add). See [PDF#ViewerJS].
!!# Wiki Argument Variables
New ((Wiki Argument Variables)) added, useful in cases when feature ((Flagged Revisions)) is enabled (such as environments following ISO9001 quality certification, where revision approval is needed for document versions):
{HTML()}<pre>
<b> {{currentVersion}}</b> (current version being displayed of the wiki page<br/> when revision approval is on; added in Tiki 14.0)
<b> {{currentVersionApprover}}</b> (approver of the current version being displayed<br/> when revision approval is on; added in Tiki 14.0)
<b> {{currentVersionApproval}}</b> (approval date, in short format, of the current version being displayed<br/> when revision approval is on; added in Tiki 14.0)
<b> {{currentVersionApproved}}</b> (indicate whether current version being displayed of the wiki page<br/> is approved or not when revision approval is on; added in Tiki 14.0)
</pre>{HTML}
!!# wikiLingo
wikiLingo has been added as experimental feature. (r49859, among other commits)
See ((wikiLingo))
!!# Wiki Plugins
New or improved plugins:
!!!# Plugin AjaxLoad
Available from 14.1, this plugin can be used to load HTML into a wiki page, from another page on the same site or an external site.
See ((PluginAjaxLoad))
!!!# Plugin CatOrphans
((PluginCatOrphans|This plugin)) was extended for Tiki14 and the update backported to Tiki12 to allow more Tiki objects to be checked whether they were categorised - prior to this update only wiki pages could be checked.
!!!# Plugin Data Channel
Improved. This plugin allows to use a manual template in a profile requests. It is possible to use a custom Smarty (ie. HTML) template to create the form that is used to collect user input for the datachannel. This provides for complete flexibility.
See: ((PluginDataChannel))
!!!# Plugin FullWidthTitle
Creates a full page width title. You can use your own tpl file for the styling, and you can also indicate the source of the Icon that you want to use for that Title.
See ((PluginFullWidthTitle))
!!!# Plugin GDgraph
Available from 14.0 (and backported to the 12.x branch in March '15) ((PluginGDgraph|this plugin)) displays a graph/chart as an image using x,y pairs of data placed in the plugin body. The x,y pairs, or indeed the whole plugin format, could be generated by using another plugin eg TRACKERLIST or LIST.
This plugin is a simple alternative to using the more feature rich ((PluginR|R plugin)) for web sites where it is not possible or easy to install all the necessary libraries, etc., on the server to enable the R plugin.
Only a bar chart option is currently available - other display options could be developed
!!!# Plugin Like
PluginLike allows users to assign a like button to particular objects, as seen on many social networking sites.
See ((PluginLike))
!!!# Plugin List
PluginList can be used with tablesorter. Use a {tablesorter} tag to add the tablesorter parameters.
See ((PluginList))
!!!# PluginListExecute
Since version 15.3, you can select columns and customize output of the table with items to be processed, using the same syntax as ((LIST - OUTPUT command)), which also allows for context filtering and inline edition of records before mass execution of actions on groups of items.
Added ((Advanced Rating)) calculations as ListExecute actions
See ((PluginListExecute))
!!!# Plugin Tour
Quick and easy way to build your product tours with Bootstrap Popovers. This plugin makes page tours using [http://bootstraptour.com/|bootstrap-tour].
See ((PluginTour))
!!!# Plugin Tracker
Plugin tracker's transaction feature enables a sequence of trackers to be chained into a single transaction, which is submitted only after the user submits the last tracker form. Otherwise the transaction is cancelled.
In addition, wiki page templates can be used for email notifications using the "__wiki:page name tpl__" format instead of template_name.tpl files in the templates/mail dir. Tiki will use a page "page name subject tpl" if found.
See ((PluginTracker))
!!!# Plugin UserInGroup
Use this wiki plugin to check whether a specific user is in a designated Group and to display defined text for either case.
See ((Plugin UserInGroup))
!!!# Plugin XMLUpdate
Allows multiple elements of an XML file stored in a File Gallery to be updated - the File Gallery (at present) must store all files in a Directory instead of using the database storage option.
See ((Plugin XMLUpdate))
!!# Wiki Structures
A wiki structure can be __locked__ since Tiki15, meaning that the pages that are in a structure and the order/hiererchy of these pages can only be changed by the locking user. A new preference and new permissions to lock/unlock or to admin the whole structure are introduced associated with this improvement, as well as a new section in the permissions management UI.
See ((Structure User))
!!# Upload and download translations
It is possible to upload translation files from the user interface.
{img src="display1276" link="display1276" width="400" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}
Allowed file types:
- Tiki custom.php: a custom.php file with your custom translations
- Tiki language.php: a regular Tiki translation file
- Transifex php: a translation file from Transifex Tiki translation project ([https://www.transifex.com/tiki/])
{img src="display1275" link="display1275" width="400" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}
It is also possible to download custom.php and language.php files for a selected language from the frontend
{img src="display1277" link="display1277" width="400" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}
{img src="display1278" link="display1278" width="400" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}
!! Known Installation Issues
!!! Timeout when installing with InnoDB option
We are aware that a minority of users have timeout issues when choosing InnoDB instead of MyISAM as the database engine in the web installer. This is not a new issue and affected Tiki 12.2 also. This affects only certain server environments. The workaround for this problem is to install using MyISAM and then running db/tiki_convert_myisam_to_innodb.sql in order to convert the databases to InnoDB.
!!!Problem with installing in subdirectory with a tilda
Users have reported problems with installing in subdirectories with a tilda (~) in the URL. This problem affects Tiki 12 too.
{ANAME()}Upgrading{ANAME}{ANAME()}upgrading{ANAME}{ANAME()}upgrade{ANAME}{ANAME()}Upgrades{ANAME}{ANAME()}upgrades{ANAME}{ANAME()}Update{ANAME}
!! Upgrade
You need intl, curl and dom extensions in PHP5 (ext-intl & ext-curl & ext-xml). See above the section [#Server_requirements] for more instructions.
!!! Theme upgrade notes
When upgrading an old site, you will experience disruptions in visual look and feel, but at the same time you will see much improvement to a modern and responsive look.
Nevertheless, you will need to upgrade your theme to Bootstrap, or choose a theme which is bootstrap-ready from somewhere else. Also, some reconfiguration will be required. Please see below.
For more information, see:
* http://themes.tiki.org/Bootstrap
* http://themes.tiki.org/Bootstrap+-+CSS+Development
* http://themes.tiki.org/Bootstrap+-+Smarty+Templates
Since file design.css has been renamed to tiki.css, any customization to that design.css file on disk must be ported to the new tiki.css
!!! Top and topbar modules
Note that top and topbar modules will now go full width by default. You will find that things like search and menu bars might be full width which is not what you want. To reduce their width, go to Admin..Modules and set under "Appearance" a "Containing Class".
For example, if you set the containing class to col-md-9 (e.g. the top menu on Tiki.org sites), the module will take up 9 out of the 12 columns of the bootstrap grid. If you set the containing class to col-md-3 (e.g. the top search bar module on Tiki.org sites), the module will only take up 3 out of 12 columns of the bootstrap grid.
!!! jQuery-UI Theme may need to be set to something
In Tiki 12 you might have set the Jquery-UI theme to None in order to avoid other issues, but now in Tiki 13 you might find that jQuery-UI popups might have a transparent background. To fix this, simply set the jQuery-UI theme to something or reset it to the default.
!!! Bootstrap style menus
If you have menus using the following syntax, e.g. in custom modules:
{CODE()}
{menu id=42 css=y type=vert}
{CODE}
You will need to add bootstrap=y on order to get the bootstrap version
{CODE()}
{menu id=42 bootstrap=y css=y type=vert}
{CODE}
Bootstrap has a mobile focused approach and so prefers to have one level deep menus as these are considered best for mobile devices. So for bootstrap style menus you should have section level 0 and options at Tiki menu administration.
If you want a deeper menu structure than set the "Use Bootstrap menus" option at module administration to "n" in order to escape Bootstrap styling and preserve multi-level menus (section level 1, section level 2, section level 3).
{img src="display1115" link="display1115" width="400" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}
Use bootstrap=n in case you include a menu in a custom module or tpl.
{CODE()}
{menu id=42 bootstrap=n css=y type=vert}
{CODE}
!!! Convert PluginSplit to PluginDiv
For fluid responsive flow of page elements in Tiki15 compared to Tiki12, you need to replace ((PluginSplit)) calls with the appropriate ((PluginDiv)) equivalent calls.
For instance, this plugin Split
{CODE()}
{BOX()}
{SPLIT(colsize="25%|75%")}
Foo
---
Bar
{SPLIT}
{BOX}
{CODE}
which produces this output:
{BOX()}
{SPLIT(colsize="25%|75%")}
Foo
---
Bar
{SPLIT}
{BOX}
Should be replaced with these other Plugin Divs:
{CODE()}
{BOX()}
{DIV(class="col-sm-3")}
Foo
{DIV}{DIV(class="col-sm-9")}
Bar
{DIV}
{BOX}
{CODE}
which produces this other output:
{BOX()}
{DIV(class="col-sm-3")}
Foo
{DIV}{DIV(class="col-sm-9")}
Bar
{DIV}
{BOX}
!!! Behavior change of Tracker field "Dropdown with other"
The default behavior of the tracker field "Dropdown with other" changed in Tiki 15, due to some [https://dev.tiki.org/item5610|validation issues with previous behavior]
You need to select the option "other" in the dropdown (in lowercase) for the extra input text field to be shown for the user.
!! Behavior change of Tracker field "Item Link"
In some cases you will need to change the __"One item per value"__ property of the field to ''"Display only one item for each label"'' (from "''Displays all the items for a same label with a notation value (itemId)''") to maintain the previous behaviour as the -+multi+- option now works correctly.
!!! Floated box class styles are now redundant
Instances of div classes in wiki text etc. (such as divs thirdfloat, to have display in 3 cols), should be replaced by Bootstrap grid divs.
More information:
http://themes.tiki.org/Floated+box+demo
!!! Plugins need approval
After upgrading, if you have plugins throughout the site that need approval, you can goto tiki-plugins.php (as a admin) to approve them all. There is a button at the bottom of that page to approve all plugins.
!!!Themes
Since the structure of themes changed singificantly for Tiki14, the main task is expected to be to upgrade custom themes. And you may have to re-select the theme style you want to use, through the ((Look and Feel|Look & Feel)) control panel.
Please note:
* your old css files will probably need to be reviewed modified as many selectors have been adjusted to bootstrap
* an upgrade patch is provided that modifies your database. The change is focusing on removing ".css" from the end of the theme values in as shown below:
{CODE()}
UPDATE `tiki_preferences` SET `name` = 'theme' WHERE `name` = 'theme_active';
UPDATE `tiki_preferences` SET `name` = 'theme_option', `value` = REPLACE(`value`, '.css', '') WHERE `name` = 'style_option';
UPDATE `tiki_user_preferences` SET `value` = REPLACE(`value`, '.css', '') WHERE `prefName` = 'theme';
UPDATE `tiki_user_preferences` SET `prefName` = 'theme_option', `value` = REPLACE(`value`, '.css', '') WHERE `prefName` = 'theme-option';
UPDATE `tiki_theme_control_categs` SET `theme` = REPLACE(`theme`, '.css', '');
UPDATE `tiki_theme_control_objects` SET `theme` = REPLACE(`theme`, '.css', '');
UPDATE `tiki_theme_control_sections` SET `theme` = REPLACE(`theme`, '.css', '');
UPDATE `users_groups` SET `groupTheme` = REPLACE(`groupTheme`, '.css', '');
{CODE}
If you want to provide some border to the icons in action bars, you can do so with extra css rules in the Custom CSS section of the Look And Feel Control panel:
{CODE(colors="css")}
.btn-link, .btn-link:hover, .btn-link:focus, .btn-link:active {
border-color: lightgrey;
}
{CODE}
If you want icons bigger, in general, you can increase their size 20%, for instance, by adding 1.2em size to their class:
{CODE(colors="css")}
.icon {
font-size: 1.2em;
}
{CODE}
And if you use [http://themes.tiki.org/Less|Less], you can have a border-color adapted to your current choice of theme is you use the variable: @button-hover-border-color , which is defined by each theme's variables.less file.
For more information on these theme-related topics, see the section about "[#Themes|Themes]" above.
!!! Multilevel menus in modules
Menus in modules are now by default "bootstrap" menus, meaning that following bootstrap's idea they are suggested to be only one level deep.
If you have a deeper sublevel structure you need to set your menu module to be none-bootstrap to show all sublevels.
{img src="display1252" link="display1252" width="400" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}
!!! Regular Expressions in fields requiring validation
See above [#Validation_syntax]
!!! 'SSL connection error' or error displaying HomePage after upgrade of SSL enabled websites
If your SSL enabled website shows a port number in the address bar of the browser ( http://www.example.com:80 for example) which results in a SSL connection error, then one way to fix the issue is to edit the .htaccess file in the tiki root directory, as follows:
{CODE(caption="Add the comment \"#\" character to the start of the following line in .htaccess")}DirectoryIndex index.php
{CODE}
{CODE(caption="Remove the comment \"#\" character from the start of the following line in .htaccess")}DirectoryIndex tiki-index.php index.php
{CODE}
The ControlPanels | Login page | General Preferences has settings which should be checked post upgrade toinsure that they have transferred correctly for your installation. These include, amongst others:
*Protect all sessions with HTTPS
*Use HTTPS login
*HTTP Basic Authentication
*Users can choose to stay in SSL mode after an HTTPS login
*Users can switch between secured or standard mode at login
*HTTP port
*HTTPS port
Additionally, if the HomePage does not display correctly or shows a permission related error then the settings in ControlPanels | General | Navigation should be checked:
*Use Tiki feature as homepage
*Use custom homepage
*Wiki Home page
*Domain prefix handling
*Domain redirects
!!! JQuery selectors for forms
Since most html tables (mainly produced by ((Trackers)), but also in other cases) have been replaced with html div's in the migration to Bootstrap in the last couple of Tiki releases, the former way in jquery to select a row in a form needs to be updated.
Or if using your custom templates in a ((Pretty Trackers)) setup, then you will need to surround your tracker fields with custom calls to plugin div, and refer in your ((PluginJQ)) call to those div id's, etc.
Ask in the ((two:Lists|developers list)) if you need more help on this topic (or consider hiring a ((two:Consultants|Consultant)) to do the ugprade work for you, if that suits better your needs and possibilities).
!!! Potential Issue: Composer error
For people who install through ''svn up'' then ''sh setup.sh'', at upgrading time the "c" command under certain conditions can blow up with a:
~np~ [RuntimeException]~/np~
Could not scan for classes inside "vendor/smarty/smarty/libs/sysplugins/smarty_security.php" which does not appear to be a file nor a folder.
This does not happen reliably, but it is easy to step around with a simple:
{CODE()}rm -rf vendor/smarty/{CODE}
Then ''sh setup.sh'' works fine.
{maketoc title="" levels="2,3"}
!!! General upgrade notes
Also, see the standard information about ((Upgrade|Upgrades)) in Tiki.
!! Removed features
* Ability for users to toggle left or right columns on/off by themselves (a feature request to put this back exists)
* Ability to override/let user control Module area visibility in Admin...Look and Feel is not possible anymore. If there is a module to show in the area, it will show automatically.
* Nested wiki-plugins are not allowed in Custom ((Module)) anymore. It will cause a Smarty error.
* ((Metrics Dashboard))
-=Pages linking to Tiki15=-
{backlinks}
-=Alias=-
(alias(Tiki15.0from12)) | (alias(TikiWiki15from2)) | (alias(TikiWiki15.0from2)) | (alias(TikiWiki 15.0from2)) | (alias(TikiWiki 15from2)) | (alias(Tiki 15from2)) | (alias(Tiki 15.0from2))