Loading...
 

Overview

This page gives users further information on the Multi-like feature. This feature allows configurators to set multiple "like" options rather than just a simple "Like" button.

For a simple "Like" feature, you can make use of the PluginLike

Click to expand
Click to expand

FAQs

What does this Multi-Like feature do?

  • The idea behind multi-like is to be able to expand on the like functionality to allow users to provide more qualitative feedback to the system.
  • Rather than just allowing users to like/unlike things, multi-like allows users to select from a preset set of values. Multi-like also allows admins to provide numeric values to those selected options to provide a score for individual selections.
  • Multi-value can be used on any Tiki object (article, forum, blog, trackeritem, etc)

Are there any limitations to this feature?

  • Multi-like is not yet a mature feature and has its limitations. It works but hasn’t been refined as of yet.
  • Visually, it still needs some work to make it look good. It can be templated over though in themes as well.
  • It also has yet to be incorporated into the core Tiki templates for forums, articles, blogs, etc. The idea was to hold off on doing that until it’s matured and we see if this is a feature that the community will want built-in.

Is it complicated to use? Are there any knowledge pre-requisites?

At this stage, Multi-like is not a particularly complicated feature but requires some knowledge of Smarty templates, Smarty functions, and how the Tiki file structure is set up to use properly.

Configuration

Multi-like configuration requires accessing the “Community” Control Panel with the “Advanced” feature on. Look for the preference titled "Configuration for multilike". Note that every configuration must be separated by a blank line.

OptionsDescriptionExample
relation_prefixThis is the prefix used for the relation.
Should be a two-part string, separated by a period and no spaces.
tiki.multilike1
idsThese are the ids for the various options.
These are mandatory.
good,great,excellent
labelsThese are the various labels for the options from which users can choose.
These should be comma separated values
This was good,I thought this was great, Really excellent!
values(Optional) You can set these to assign numerical values to the respective labels.
These should be comma separated numbers, and the values count should equal the labels count.
1,3,5
allow_multi(Optional) Sets whether you should be able to select multiple labels (like checkboxes).
This should be set to 'y' if you want use 'checkbox' functionality. Otherwise it functions like radio buttons.
y (default: n)
icon_unselectedSince Tiki19, the name of the icon that will be use when no click has been recorded yet. By default it display a thumbs-up icon (outilned)arrow-circle-up
icon_selectedSince Tiki19, the name of the icon that will be use when a click or more has been recorded. By default it display a thumbs-up icon (plain)arrow-circle-down

Example value for configuration/preference field

relation_prefix=tiki.multilike1
ids=a,b,c
values=1,3,5
labels=Good,Great,Excellent

relation_prefix=tiki.multilike2
ids=a,b,c
labels=Creative,Interesting,Factual
allow_multi=y

This would initialize two possible multi-like configurations that could be used (note the blank line between the two configurations; this is required).

  • The first would be “radio button”-styled and would let users select from Good, Great, and Excellent
  • The first would be checkbox-styled and would let users select from Creative, Interesting, and Factual

Permission configuration

Until better permission handling is developed for Relations, tiki_p_post_comments will be used to check permissions.

Using a multi-like configuration in a Smarty template

Once multi-like is configured (see previous step), you may call it in a Smarty template using the "multilike" Smarty function. The parameters you must pass to this function are explained below:

OptionsDescriptionExample
relation_prefixThis is the prefix used for the relation as defined in the configuration.
Should be a two-part string, separated by a period and no spaces. (Required)
tiki.multilike1
typeThis is the type of object that is being rated/liked. (Required)article
objectThis is the id of the object being liked. In most cases, you would likely assign a variable to this parameter. (Required)$articleId
onlyShowTotalPointsIf set to 'y' total number of points for object will be returned as an integer (Optional, 'n' by default)onlyShowTotalPoints='y'
onlyShowTotalLikesIf set to 'y' total number of likes for object will be returned as an integer (Optional, 'n' by default)onlyShowTotalLikes='y'
showOptionTotalsIf set to 'y' each option will display their individual like counts next to label (Optional, 'n' by default)showOptionTotals='y'
showPointsToggle the display of total points for object (Optional, 'n' by default)showPoints='y'
showLikesToggle the display of likes for object (Optional, 'n' by default)showLikes='y'
choiceLabelProvide a custom label for choices (Optional, default label is 'I found this:')choiceLabel='This article was:'
orientationSet template orientation. Value can be either 'horizontal' or 'vertical'. (Optional, horizontal by default)orientation='vertical'
showInPopupSet whether the options should be contained in a popup (optional, 'n' by default)showInPopup="n"
popupPlacementSets the placement of the popup (Optional, 'left' by default)popupPlacement="top"

Example Smarty code to call a multi-like configuration

{multilike relation_prefix="tiki.multilike1" type="wiki page" object=$page}

Example of a like / unlike usage

In this case we want to set 2 multilike plugins, one for like and one for unlike, using different icons (added in Tiki19).
Note: sonce Tiki19 we upgrade to font Awesome 5 and there is still work to be complete about outlined icons

In the multilike parameters text area;

relation_prefix=tiki.multilike1
ids=a
values=1
labels=like
icon_selected=thumbs-up
icon_unselected=thumbs-o-up

relation_prefix=tiki.multilike2
ids=a
values=1
labels=don't like
icon_selected=thumbs-down
icon_unselected=thumbs-o-down


In a module;

{multilike relation_prefix="tiki.multilike1" type="wiki page" object=$page showOptionTotals='y' showLikes='n' choiceLabel=' '}
{multilike relation_prefix="tiki.multilike2" type="wiki page" object=$page showOptionTotals='y' showLikes='n' choiceLabel=' '}

doc.tiki.org

Bootstrap AdminGuide UserGuide

Keywords

Keywords serve as "hubs" for navigation within the Tiki documentation. They correspond to development keywords (bug reports and feature requests):

Accessibility (WAI and 508)
Accounting
Articles and Submissions
Backlinks
Banners
Batch
BigBlueButton audio/video/chat/screensharing
Blog
Bookmark
Browser Compatibility
Link Cache
Calendar
Category
Chat
Clean URLs
Comments
Communication Center
Compression (gzip)
Contacts (Address Book)
Contact us
Content Templates
Contribution
Cookie
Copyright
Credit
Custom Home and Group Home Page
Date and Time
Debugger Console
Directory of hyperlinks
Documentation link from Tiki to doc.tiki.org (Help System)
Docs
Draw
Dynamic Content
Dynamic Variable
External Authentication
FAQ
Featured links
File Gallery
Forum
Friendship Network (Community)
Gmap Google maps
Groups
Hotword
HTML Page
i18n (Multilingual, l10n, Babelfish)
Image Gallery
Import-Export
Install
Integrator
Interoperability
Inter-User Messages
InterTiki
Kaltura video management
Karma
Live Support
Login
Logs (system & action)
Look and Feel
Lost edit protection
Mail-in
Map with Mapserver
Menu
Meta Tags
Mobile Tiki and Voice Tiki
Mods
Module
MultiTiki
MyTiki
Newsletter
Notepad
Payment
Performance Speed / Load
Permissions
Platform independence (Linux-Apache, Windows/IIS, Mac, BSD)
Polls
Profiles
Profile Manager
Report
Toolbar
Quiz
Rating
Feeds
Score
Search engine optimization
Search
Search and Replace
Security
Semantic links
Shadowbox
Shadow Layers
Share
Shopping cart
Shoutbox
Slideshow
Smiley
Social Networks
Spam protection (Anti-bot CATPCHA)
Spellcheck
Spreadsheet
Stats
Surveys
Tags
Task
Tell a Friend, alert + Social Bookmarking
TikiTests
Theme CSS & Smarty
Trackers
Transitions
TRIM
User Administration including registration and banning
User Files
User Menu
Watch
WebDAV
Webmail
Web Services
Wiki History, page rename, etc
Wiki Plugin extends basic syntax
Wiki Syntax
Wiki structure (book and table of content)
Workspace
WSOD
WYSIWYCA
WYSIWYG
XMLRPC

Tiki Newsletter

Delivered fresh to your email inbox!
Newsletter subscribe icon
Don't miss major announcements and other news!
Contribute to Tiki
Show PHP error messages