Loading...
 
Skip to main content

History: Toolbar

Source of version: 16 (current)

Copy to clipboard
            ! Quicktags (a.k.a "Toolbars" of quicktags) & WYSIWYG Toolbar
Quicktags are user definable actions that allow ((Wiki-Syntax Links|Wiki Syntax)) to be inserted into text when editing or creating Wiki pages.  They appear as little icons either to the left or above (depending on which version of Tiki you are using) the main text area.  Many common formatting/display options are already defined by default, but you may add or delete Quicktags as you wish by going to the Quicktags Admin page (''tiki-admin_quicktags.php''), assuming you have appropriate permissions.  Distinct Quicktags can be assigned to different features of Tiki, for example you can have one set of Quicktags for creating/editing Wiki pages and one set of Quicktags for creating/editing Articles. Since Tiki Wiki is using [http://ckeditor.com/|CKeditor] to provide a wysiwyg user friendly toolbar you have another way to provide formatting tools to the editor of a text-aera. Wysiwyg editor is globally less pwerfull than the Quicktags (wiki syntax) and more usual for the common user as the wysiwyg toolbar it is very close to what can be found in common word processor.

!!Using Quicktags
With most of the Quicktags they are used by highlighting the text you wish to add syntax for then clicking on the appropriate icon.  The appropriate Wiki Syntax will then be wrapped around the highlighted text.  In some cases no highlighting of text is required such as when you use the Quicktag to add a new table.  In this instance appropriate text for a table will be inserted at the current position of the cursor in the text area.  In all cases Tiki uses JavaScript to manipulate text so you must ensure your browser has JavaScript enabled otherwise Quicktags won't work.  (You most likely do have it enabled since there are other areas of Tiki where is it required too).

!!Using wysiwyg toolbar
Wysiwyg toolbar items are intuitives and very easy to use. You can both click on an item to set what will happen to the coming text or select text or elements and apply formatting. Some, of the toolbar items like "image" (to add a picture) work differently but again are very intuitive and aimed for non-technical users.

ith most of the Quicktags they are used by highlighting the text you wish to add syntax for then clicking on the appropriate icon.  The appropriate Wiki Syntax will then be wrapped around the highlighted text.  In some cases no highlighting of text is required such as when you use the Quicktag to add a new table.  In this instance appropriate text for a table will be inserted at the current position of the cursor in the text area.  In all cases Tiki uses JavaScript to manipulate text so you must ensure your browser has JavaScript enabled otherwise Quicktags won't work.  (You most likely do have it enabled since there are other areas of Tiki where is it required too).

!!Admin Quicktags
You can edit the quicktags of your site by going to admin->quicktags.
If you want your quicktag to use the selected string of your textarea, you must use the string text. For example if you want to bold the selected text, the insert must be ~np~__text__~/np~.

!!!Ordering Quicktags
The order in which the Quicktags appear for each feature is currently not user definable directly (as of version 2.0), however there is a manual workaround that allows you to manipulate the order in which they appear.  The Quicktags are always displayed in reverse alphabetical order (i.e. from 'z' to 'a') so the order in which you enter them on the Admin page does not matter.  To force Tiki to display them in a certain order, prefix each Quicktag label with a number, and simply number all the Quicktags in descending order.  For example if you want the bold Quicktag icon to appear as the first icon make sure that you add to the label the highest number of all the numbers you use.  Thus, If you have ten quick tags you should label the bold Quicktag something like "10 Bold" and then the next Quicktag "9 <labelname>" etc.  The label name that is prefixed with "1" will appear as the last icon.

Another trick is to add spaces before the label (you need to do that directly in the database). The more space, the more on the right. In tw>=3.0, the leading spaces are trimmed when displayed.

!!New in ((Tiki2))
In versions prior to 2.0, the Quicktags were always displayed to the left of the text area but version 2.0 now features an option to display them above the text area.  You can find this option under ''Admin->Text Area'', and is called "''Show quicktags over textareas (instead on left side):''".

!! New in ((Tiki4))
In ((Tiki4)) the admin interface for toolbars of quicktags has been revamped and nowadays it allows drag and drop selection of items to be added or removed from custom toolbars to be shown in Tiki sections.

!! Wysiwyg Toolbar
Since wysiwyg introduction you can admin the wysiwyg toolbar using the same way than for the Quicktags (/tiki-admin_toolbars.php) with drag'n'drop system.

::{img src=http://doc.tiki.org/dl167 class=reflect}::

!!See Also
You may prefer not to have to use Wiki Syntax at all in which case you might like to try the new (as of version 2.0) ((WYSIWYG)) editor via FCK Editor.  

old doc:
[http://tikiwiki.org/tiki-index.php?page=QuickTags]

! Alias
* (alias(Toolbars))
* (alias(QuickTag))
* (alias(Quicktags))