History: Structure Admin

            !Structures Admin

!!Managing Structures
To manage your Wiki structures, select __Wiki__ > __Structures__ from the menu. 
*In version 1.9, this menu option is available only if you have the __tiki_p_edit_structures__ permission.
*In version 2.0, this menu option is available to all users, but the __Create new structures__ area is available only if you have the __tiki_p_edit_structures__ permission.


Starting with version 2.0, the ability to remove, create webhelp, and dump tree (see description of these functions below) respects the permissions (whether object or category) set on the structures 'root' page. Users must have __edit__ rights on this 'root' page to access these functions. The ability to view/access in the listing, also respects the permissions (whether object or category) set on the structures 'root' page.

In 1.10, activation of the "create webhelp" feature is also controlled by an option in the admin ((Wiki Config)) screen.

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

!!! Page versus Page in a structure
If you want by default that a page opens as a part of a structure, you have to check
admin-> wiki -> Open page as structure:
In this case the url tiki-index.php?page=Structures will display the structure navigation.
If you do not check this option, the url tiki-index.php?page=Structures will not display the structure navigation, only the url tiki-index.php?page_ref_id=104 will do it

!!Structures
A list of existing structures is displayed along with the following icons:

{CENTER()} ||::__Icon__::|::__Action__::|::__Description__::
{img src=img/icons/export.gif}|Export| Exports the wiki source the wiki pages in the structure
{img src=img/icons/expand.gif}|Dump tree|Exports the tree of the structure suitable for copying or editing
{img src=img/icons2/delete.gif}|Remove|Deletes the structure and optionally the associated wiki pages
{img src=img/icons/whelp.gif}|Create webhelp|Generates an tree menu and static HTML pages from the structure
{img src=img/icons/whelp_toc.gif}|View webhelp|View the generated webhelp|| {CENTER}

!!Create New Structures
Use the __Create new structure__ area of the Structures Admin page to create a new wiki structure.

^::{img src="img/wiki_up/create_new_structures_01.png" alt="Create new structure"}::^

{FANCYTABLE(head="Field ~|~ Description")}
Structures ID ~|~ The wiki page that will be used as the "root" of the structure. If the page does not exist, TikiWiki will create the wiki page. %%% Required
Alias ~|~ An alternative name for the Structures ID. By using an alias, you can create two different structures (each with a different Structures ID) that ''appear'' to be named identically. %%% Optional %%% Using an alias is helpful for creating structures with common names that will be reused (such as __Introduction__ or __Overview__) or when your structure contains 2 different names for of the same pages (ex: page: 2.1-> page: this 2.1 (alias: this)  and page: 2.2 -> page:this 2.2 (alias: this) will be displayed as 2.1->this, 2.2->this ))
Tree ~|~ Use the __Tree__ area to create a structure and the necessary wiki pages. TikiWiki will automatically create the necessary wiki pages and add them to the structure. See {ALINK(aname=Creating_a_Tree)}Creating a Tree{ALINK} for details. %%% Optional
{FANCYTABLE}

!!!Creating a Tree
When creating a new structure, TikiWiki can automatically create the necessary Wiki pages within the structures for you. Simply add the name of each wiki page in the __Tree__ field. Each line indicates a consecutive Wiki page in the structure. 
*To create a child page, indent the wiki name with a space.
+For example:
+{CODE()}
Parent Page
 Child Page
  Deeper Child Page
{CODE}
*To create an __alias__ for the wiki page, append the Wiki name with __-> alias__.
+For example:
+{CODE()}
Wikipage001 -> Introduction
{CODE}

An example of a completed __Tree__ might look like this: 
{CENTER()}{BOX(title=>"Tree Example")}{CODE()}
Wiki -> Introduction
 Using Wiki Pages
  Wiki Links
  Wiki Lists
  Wiki Images
  Wiki Text Formatting
  Wiki Special Characters
 Wiki Admin -> Administration
 Wiki Details
{CODE}{BOX}{CENTER}

To create a new structure upon this dump tree, you would need to add just the structure name, and optionally an alias. In this example, the form to create a new structure would look like:

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

__Categorize the Structure__
When you create a structure you have (if the ((categories)) feature is active) the opportunity to categorize the whole structure. 

^Note: In what appears to be a ((bug)) you cannot re-categorize a whole structure after creation.^

If you are using the __staging and approval system__ ((Wiki Page Staging and Approval)), you will FIRST have to remove the existing category (the approved one) from the structure before assigning your structure to the new category.

* Otherwise the permissions from the new category will not be reguarded, even if you enabled the ''"Permission to all (not just any) of an object's categories is required for access"'' under tiki-admin.php?page=category.

__Assign Permissions to the Structure__

If you want to set object specific permissions to the pages of a certain structure, you will have to remove the existing category, too.

* Otherwise the object specific permissions won't override the ones given by the approved-category. So the warning ''"These permissions override any global permissions or category permissions affecting this object."'' will not affect in case of using the staging and approval!

!!List of Structures
After you create this structure, you'll have a nine page group of wiki pages, including whatever amount of those pages that were already created in the same Tiki site. And you will see the structure listed like:

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

If you click on the name of the new structure created (''"Feature001 (Feature Wiki)"'', in this example), then you will be able to manage the structure: move nodes, add brand new pages to it or from existing pages in the same Tiki (see further down), and you will be able to see the structure layout:

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

For instance, if you click on the __view__ link, next to "''1. Wiki(Introduction)''" node, you will see the page "Wiki", named as "Introduction", with all the navigation aids at the top of the page. 

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

If you add a "toc" ("table of contents" tag) to that page (regardless that you are at the root page of the structure or not), you will see the table of contents for that page (Wiki).  For instance, adding this code to the page:
{CODE()}{toc shownum=1 }
{CODE}

would produce a numbered table of contents of the child pages starting from this node (but not the ones in the same level as this page or higher levels):

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

__Tip_: See ((Structure User)) for more information on the __toc__ tag syntax and optional parameters allowed.

When your user belongs to a group with the permission "tiki_p_edit_structures", you will see a mini-form on each navigation bar to create new pages if needed just after this one, or as child pages from this one if you select the "''Child''" check box next to it (see example just above).

When you are not logged in, or a user in groups without this permission, you would see a plain navigation bar on top of each page:

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

The following sections explains you how to create, delete, move, and re-prioritize the pages in your structure

!!Editing an Existing Structure
Select a Structure from the list to open the 'modify structure' page. In this example, it is ''"Feature001 (Feature Wiki)"'', as seen from the list of structures:

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

In 1.10, the ability to edit an existing structure respects the permissions (whether object or category) set on the structures 'root' page. So a user must have edit rights on that 'root' page to be able to edit the structure. A user with view rights but no edit rights on that 'root' page will be able to access the structure tree, but not edit it.

The form at the top of 'Modify Structure' page (__tiki-edit_structure.php?page_ref_id=1__, in our example) indicates the current node. The default selected node is the structures 'root' page. Select an alternative structure node to edit from the 'Structure Layout' tree at the bottom of the page (selected "''Using Wiki Pages''" node in this example):

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

Use the 'Update' button to add or update the current nodes 'Page alias'.

Use the navigation buttons to move the current node to a different position within the 'Structure Layout'. The current node will be highlighted in bold (except the root node, which is never highlighted).

!!!Adding Pages to Current Node
Any pages that you add will be added as sub-pages to the 'current node' and inserted after the page indicated by 'After Page'.
*If you enter a Wiki name in the 'create page' field, a new Wiki page of this name will be created. If populated, this field takes precedence over the 'Use pre-existing page' field.
*The 'Use pre-existing page' field allows the user to insert one or more existing pages. The filter field can be used to restrict the set of existant pages.

!!!Structure Layout
The 'Structure Layout' provides links to:
* View the referenced wiki page: Only if you have the relevant permissions
* Edit the referenced wiki page: Only if you have the relevant permissions
* Remove the page reference from structure: If you click 'x' to remove a page, the system will ask if you want to remove the page from the structure or if you want to remove the page completely. 

Note that if the page being removed has subpages, all the subpages will be removed recursively from the structure. (The underlying wiki pages will also be removed if you choose the 'remove page too' option) 

!!Table Of Contents 
See ((Structure User)) for more information on the table of contents syntax (using the __toc__ tag) and optional parameters allowed.

!!Slide Show
If the [http://doc.tiki.org/Slideshow|slideshows feature] is enabled, selecting the 'slides' button from the page bar will display structure pages as slideshows!

!!PDF Creation
If the pdf-creation feature is enabled, selecting the 'pdf' icon whilst viewing a structure page will populate the pdf document with the relevant wiki pages from the structure. (chris.holman: Aliases and toc items dont work at present)

!! Webhelp
The basic idea is to generate a WebHelp from a Tiki Structures (Structure = a tree of wiki pages as you know)
From the structures menu you will see a button to create a webhelp ({img src=img/icons/whelp.gif}).

The webhelps are created in whelp/$name where name is configurable and defaulted to the name of the root of the structure.

The generated webhelp is a static representation of the structure with a js tree that can be used to navigate the structure and a search function, print function, history and some other gizmos.

This feature aims to allow distributing whatever documentation you create through structures at your Tiki site in an usable format for users. Since structures can be re-created whenever you want, you can also keep an online version in your site updated quite easily.

^::{img src="img/wiki_up/structures_webhelp_01.png" link="http://themes.tiki.org/whelp/Tiki%20Transforming/index.html" }::^

Example of Usage:
* [http://themes.tiki.org/whelp/Tiki%20Transforming/index.html]

!! Structures Watch
Tikiwiki >=1.10
A user can watch a structure or a sub-structure, if he has the permission tiki_p_watch_structure. He will watch all the pages in the sub-tree that has the watched page as root.
He will receive a notification email each time a page in the sub-tree is changed or a page is removed from the sub-tree or inserted into the sub-tree.

__Quirk in creating Structures in 1.9.1__

If you are using simple wordpad like file app to creat a simple structure and you indent more that one space from one level to the next, it will create anything below that line with more than one space indent as a separate structure.  Watch your spaces.

!!Structure in a module
It is possible to put a structure in a module by using the smarty syntax
~np~{wikistructure id=1}~/np~

With tw >=4.0, it is possible to represent a structure like a menu, and so to use all the menus feature, like display as a css/suckerfish menu or highlight the current page
~np~{menu structureId=1)~/np~ to display a structure like a tiki collapseable menu
~np~{menu structureId=1 css=y type=vert}~/np~ to display a structure like a suckerfish menu 
By using the parameter ~np~menu_cookie=n~/np~ you can also have an automatic open/close of the section of the structure the displayed page is in. This option overpasses the open options memorizes during navigation by the cookies. 

With tw = 6.1, the following works nicely:
Go to the Admin Modules page, click on the User Modules tab, and in the ‘Create new user module’ ‘Objects that can be included’ window select the Wiki Structure you want from the drop down list and click the green '+' button. This will insert {wikistructure id=123} into the wiki-syntax box. Take note of the actual number on your system (which is unlikely to be '123'), as I don't know of any other way of finding out your structure's number. If you want your structure navigation to wrap nicely, do these next steps. 
Replace {wikistructure id=123} with {menu structureId=123 css=y type=vert}
Enter the name, title etc and Save
Click on the Assign/Edit modules tab.
In the Assign new module section, in the drop-down box, click on the module name you just created.
Then fiddle with the order, perhaps move the other modules on the left side to the right side, save it, and you have a nice navigation system.
More documentation is needed re further current options, but the above looks quite nice and will suit many needs. I couldn't get the ~np~menu_cookie=n~/np~ parameter to work.

===Create a Menu from a structure toc  ===

You can create ((Menus)) from structure table of contents by means of several ways:
* ((Module menu)) <- recommended, which allows vertical or horizontal menus from a structure toc
* ((Module wikistructure)) , which allows vertical menus from a structure toc
* ((Module menupage)) plus hand written inclusion of structure tocs for a specific structId
!! Drag & drop edition (Tiki9)
In ((Tiki9)) pages can be moved position in the structure through drag and drop:

^{img src="display677" thumb="y" rel="box[g]" width="600"} ^

-=Related pages=-
* ((Structures))
* ((Structure User))
* ((Structure Details))