History: HTML Pages

            !HTML Pages
Most TikiWiki content pages (such as wiki pages, blogs, articles, and so on) in Tiki are created using Tiki's ((Wiki Syntax)) and ((plugins)). However, there may be some pages where you want to make a page entirely with HTML, for example if you want to create a web form, or a splash page, or some other kind of special content.

__Layout:__ The HTML Pages feature is still within the CMS, so the same layout can apply, or not (it's optional). 
__Permissions:__ It is easy to have the permissions for HTML pages be completely different from wiki pages.
__HTML Front End:__ HTML pages can be used as a "front end" for a site - and for pages that are not intended to be user editable. 

__Note:__ You can also place normal HTML created by any web design software files in TikiWiki's main directory and set one of them as the "home page" -- a good idea if you are finding that the tiki CMS is slow to load for first time visitors. See ((Custom Home)) for more information

!!Static or Dynamic HTML Pages
Use Tiki's __HTML Pages__ to create content pages using pure HTML (or XHTML) syntax. HTML pages can be __static__ or __dynamic__.

__Note__:
*HTML pages should adhere to [http://validator.w3.org/|XHTML Validation], since Tiki's final output is XHTML.
*HTML pages are __not__ included when using Tiki's search feature.
*HTML pages __do not__ maintain a page history.
*HTML pages __can not__ have attachments.

!!Static vs Dynamic HTML pages
When creating an HTML page, you can specify if the page is __dynamic__ or __static__.
*Dyanmic pages include __dynamic zones__ (displayed within an -+<iframe>+-) that are reloaded at specified time intervals.
*Static pages are displayed as normal HTML.

---

::[http://doc.tiki.org/tiki-view_tracker.php?trackerId=8|Problem with this page? Open a Documentation Bug]::

!!Editing a page
After ((Features Admin|enabling the HTML option)), to edit HTML pages, select __Admin > HTML Pages__ follow application menu. A screen similar to the following one will be displayed:

^{img src="img/wiki_up/admin_html_pages_3_1.png" alt="Admin HTML Pages"}^

Enter the following information in each field on the Admin HTML page to create a new HTML page:
*Page name: Name of the HTML page (required)
*Template: You can choose to apply a template for HTML pages. This can be very useful to automate the creation of pages from an established template where you can indicate dynamic zones. To create a template for HTML pages, select __Admin &gt; Content Templates__ from the administration menu. See ((Content Templates)) for more information.
*Type: Specify if the page is static or dynamic. If __dynamic__, select the refresh rate (in seconds).
*Content: Enter any XHTML content. You can also include dynamic content zones within  the content area. These ''dynamic zones'' are portions of the HTML page that will be replaced by content taken from the database. 
+For example you can create the following HTML page:
+{CODE(wrap=1)}
Soccer results
&lt;table>
<tr>
&lt;td>Liverpool {ed id=liverpool}&lt;/td>
&lt;td>Man UTD {ed id=manutd}&lt;/td>
&lt;/tr>
....
&lt;/table>
{CODE}
+__Important__: When editing an HTML page line feeds are automatically converted to HTML &lt;br/> tags
+The syntax to include dynamic zones can be ~np~{ed id=name}~/np~ or ~np~{ted id=name}~/np~. The difference is what HTML element is used to edit the zone: __ed__ uses text input boxes, __ted__ uses textareas.

After creating and saving the page, it will appear in the list of existing HTML pages:

^{img src="img/wiki_up/admin_html_pages_3_2.png" alt="HTML Pages"}^

Click the __Add Dynamic Zones__ button ({img src=img/icons/page_gear.png alt="Add Dynamic Zones"} to edit each dynamic zone on a page:

^{img src="img/wiki_up/admin_html_zones_3_1.png" alt="Admin HTML Page Dynamic Zones"} ^

Note that static pages can use dynamic zones as well as dynamic pages.


!!Editing dynamic zones for a page
This is a screen where you can edit the dynamic zones for a page:
^{img src="img/wiki_up/admin_html_zones_3_1.png" alt="Admin HTML Page Dynamic Zones"} ^

Note that you just edit the zone and click update you can edit the zones from the
listing directly or clickin on edit to individually edit a zone in a larger area.
Static and dynamic pages again.

When a page is accessed using tiki-page.php?pageName=some the page will be rendered replacing the dynamic zones by their values, if no value is found then the zone is displayed as blank. Now is where the difference between a static or a dynamic page can be noticed:
*For static pages the page will be rendered and if the user wants to refresh the page to update dynamic zones the page must be reloaded by refreshing the browser as usual.
*For dynamic pages the page will be automatically updated without refreshing at specified intervals (in seconds) that can be specified when editing a page. So if a page is dynamic the dynamic zones in a page will be updated without the user refreshing the window and without forcing the page to be reloaded. This is specially useful for "live" results, stock values, auction prices, etc etc.

!!How do dynamic pages work?
So how do dynamic pages work? Simple! In dynamic pages an invisible "iframe" is used along with the page.  This invisible frame is reloaded at the interval specified as the page refresh rate. The invisible frame picks the values for dynamic zones from the database and using javascript updates the page dynamic zones without regenerating the page.

!!Permissions
The following ((permissions)) can be used to control HTML pages:
*	tiki_p_edit_html_pages -- Can edit HTML pages
*	tiki_p_view_html_pages 	-- Can view HTML pages


-=alias=-
* (alias(HTML page))