====== Rotation Pages ====== These are page templates. A template is HTML with special tags that indicate where and how to display thumbnails. When saving a template, define it as a table with dimensions (columns × rows) and specify the PATH (NOT URL!) where to save the output. Nothing appears at this path until processing—templates live in the database. Each template must have a hidden image, by which the script determines - whether images were loaded or if it was a bot and you should not count image views. Add at least one subtemplate. Example: ``` thumb ``` You can have multiple subtemplates. **Important**: The script counts clicks using the &link parameter, so it must be present in your template for click counting to work. Available variables also known as - URL of the gallery. - skimming URL of the thumb Description ID of the thumb in the database alternative description gallery content type page creation time - link, mandatory parameter, the rotation parameter, it forms a string like images/12x34x45. The &link parameter serves dual purposes: 1. **Link tracking** - Use &link=block1, &link=block2, etc. to identify which page areas get the most clicks. View results in Trade - Stats - Links. 2. **Rotation** - The script uses &link in the format images/12x34x45 for internal rotation. This format avoids confusion with tracking links like block1. Rotation links don't appear in statistics. Specify where thumbs display using tags: ``` ``` Or use the syntax ``: ``` ``` Both examples display the top-ranked thumb using the default subtemplate. For the `` tag, if no subtemplate is specified, it defaults to "default". You can specify ranges: ``` ``` Both display the top 5 thumbs. Add parameters inside the tag: ``` ``` Displays the top thumb from the Images group. **Group names are case-sensitive**. ``` ``` Displays the top thumb from Images using the my_tpl template. **Template names are case-sensitive**. Tags must be closed: ``` [optional template] ``` The optional template parameter lets you override the default template for specific thumbs. Templates are stored in the database. Files don't appear on disk immediately after creation. To force generation, go to Rotation - Specials - Force rotation. Insert the generated output into your page using an SSI include: ``` ``` ---- **Examples:** In the installation there is a default page named test.html, it is saved in scj/rot_pages/. **Default subtemplate** **example of a page using this template** Test After processing this template, a file scj/rot_pages/test.html will be created, which can then be specified in CJPages. Templates process according to Rotation - Settings (e.g., every 10 minutes or 1000 clicks). To process immediately, click Rotation - Specials - Force Rotation. ====== Archives ====== Enable archive creation with the "Create Archives" checkbox for each template. For example, if template test.html displays 10 thumbs, enabling "Create Archives" creates test1.html through test10.html (fewer files if insufficient thumbs). Add cross-links between archives using direct URLs in the templates.