History: Structures

            ! Structures
Structures organize a group of ((wiki)) pages into a tree or book that can be easily navigated by users.  The pages are placed in a hierarchy that you specify, with blank pages created where they do not already exist. Creating a structure is the fastest method for creating multiple pages at once. Navigation aids are automatically created to help users move through the structure. It's a great way to make a book.  


!! Enable the Feature
Since ((Tiki3)), the structures feature may be enabled/disabled at Admin > Wiki > Features. 

Since ((Tiki9)), structure management has been extended: nodes can be moved around in the structure tree through drag and drop. In addition, "add new page" form has been moved into a dialog and add + buttons have been added to page actions

Since ((Tiki15)) 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.

Since ((Tiki15)) also, 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 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. 

!! Requirements
There are some special permissions involved with structures, in order to allow certain actions for groups of users.
As could be expected, both global and category permissions can be granted for Structures, but as a Structure itself is not a categorisable object - whereas all the individual pages in a Structure are - the Structure permissions that apply to categorisation are 'taken' from whatever are applied to the top page of the Structure. This does provide a great deal of flexibility but can be a little confusing if not considered carefully.

Since ((Tiki15)), to make the Structure permissions more accessible/visible in the permission tables, a separate section has been created, labelled 'wiki structure' and the following Structure permissions are available. 

See: [Structure+User#Structure_permissions]


!! Add pages to structures at page creation time
You can add pages to the structure at page creation time, having them updated in real time in the structure table of contents/menus:
# You need to have a structure created already
# You have an input field above the page to add a sister page to the same structure. If you also click at the box "child" before clicking to create the page, your new page will be a child of the previous one, and not a sister.
# We have a ~np~{toc}~/np~ syntax in the page, which can explicitly say we want to display this and this structure, those levels, depth, etc.

Example: 

::{img src="display628" thumb="y" width="600" rel="box[g]" link="display628"}::

!! Create a Menu from a structure toc  

See ((Structures User))

-=Try it out=-
For example, note that this page is in fact in a structure. The house icon ( {icon name="home" size="1"}) and the arrows on top of this page - they allow you to navigate between pages of this manual which is a structure (''backwards'': {icon name="caret-left" size="1"} | ''up'': {icon name="caret-up" size="1"} | ''forward'': {icon name="caret-right" size="1"}). 

^::{img src="img/wiki_up/structures_user_main_01.png" }::^

If the user belongs to a group with the required permission (see above), you can add pages to the structure from any page which already belongs to it:

^::{img src="img/wiki_up/structures_user_main_02.png" }::^

You can create table of contents using the __toc__ syntax (explained in the following pages); e.g. the one you see on the top (or "root") page of this structure by clicking on the house icon ({img src=img/icons2/home.gif link=tiki-index.php?page_ref_id=2 }):

^::{img src="img/wiki_up/structures_user_main_00.png" }::^

!! Drag and Drop support for management (new in Tiki9)
In ((Tiki9)) pages can be moved position in the structure through drag and drop. See ((Structure Admin)) for more details.

!! Structures Drill Down menu (new in Tiki10)
A Drill Down menu for structures has been added in ((Tiki10)), so that when the user passes the mouse over a node in the line indicating the path to that node in the structure hierarchy, the names of all the children of that node will be displayed below the path to that structure node as links for easier navigation. 

{img src="display1095" link="display1095" width="600" rel="box[g]" imalign="center" desc="Click to expand" align="center" styleimage="border"}

See ((Structures Drill Down menu))


!! More information
See more information about its usage at ((Structure User)), and about managing structures at ((Structure Admin)).

!!! TwTv3 __School Tv - tutorials and help from power users to show you how to do things.__

* Xavi shows you how to use structures and also how to take multiple wiki pages into a word processor
**Part 1
::{YOUTUBE(movie=>KBewVCducWw)}{YOUTUBE}::
**Part 2
::{YOUTUBE(movie=>2GbG2U_Qa1U)}{YOUTUBE}::
**Part 3
::{YOUTUBE(movie=>E4meaktHQis)}{YOUTUBE}::

!! Related pages
* ((Structure User))
* ((Structure Admin))
* ((Structure Details))
* ((WebHelp))
[http://tiki.org/TikiWikiTV] - Channel 3

Also see: ((Multilingual structures))

-=Alias names for this page=-
(alias(Structure)) | (alias(wiki structure)) | (alias(book)) | (alias(books)) | (alias(wiki book)) | (alias(wiki books))