Instructions
Installation
- Make sure the native EE Pages module is not installed, uninstall if not
- In each weblog, turn off “Display Pages Submission Fields.” Otherwise, it will attempt to post Pages data and cause an error.
- Enable the extension CP jQuery under Admin » Utilities » Extension Manager
- Copy /system/extensions/ext.structure_ext.php to /system/extensions/
- Copy /system/language/english/lang.structure.php & lang.structure_ext.php to /system/language/english/
- Copy /system/modules/structure to /system/modules/
- Go to the Modules tab
- Click “Install” in the row for “Structure”
- Enable the extension under Admin » Utilities » Extension Manager
Upgrading
- Replace /system/extensions/ext.structure_ext.php
- Replace /system/language/english/lang.structure.php & land.structure_ext.php
- Replace /system/modules/structure
Getting Started
- Setup your weblogs & custom fields
- Assign which weblogs Structure will use under Structure » Settings
- Assign default templates for each weblog under Structure » Settings
- Create your first entries through the Publish tab and add URIs under the Structure tab while editing the entry
- Further pages can be added by the same method and assigning parents under the Structure tab or through the “add page” link next to each page
- Structure will automatically generate URIs for you if you leave them blank
- A full tutorial can be found on Jambor-ee
Configuration
- Templates can be changed any time per page by editing the “Template” dropdown under the Structure tab when editing an entry
- Structure » Settings » Weblogs: select where Structure can post data to
- Structure » Settings » Default templates: select which templates entries should be attached to
- Structure » Settings » Administer Structure: users can make changes to Structure settings and have unlimited reordering capability
- Structure » Settings » View publish/edit Structure tab: users can view the Structure tab when publishing or editing to update URLs, change templates and manage listings.
- Structure » Settings » Access Structure page: users can access the Structure module
- Structure » Settings » View add page link: users can use the “add page” functionality
- Structure » Settings » Can reorder (limited): users can reorder pages within the same level, except top level pages (this stops them from breaking top level or main navigation)
- Structure » Settings » Can delete (limited): users can delete Structure pages (except top level pages), but it does not delete the entry
- Clicking “add page” next to an existing one creates a child page and utilizes the same weblog as the parent
Displaying Content
A regular weblog tag will display content as long as you don’t have dynamic=“off” as a parameter in {exp:weblog:entries}. Pages can be linked to within {exp:weblog:entries} with the variables {page_uri} and {page_url}.
Displaying Listings
A page with “static content” can also have a listing. This is basically a bridge between the publish and edit tab with Structure for easier access for authors. This places “Add / Edit” links next to the page name. “Add” cues a new entry for the weblog it’s assigned to while “Edit” cues the Edit tab and sorts entries for only that weblog. This can only be done if you have a weblog not being used for your “static” pages and can NOT be shared with another listing. By assigning the default template under Structure » Settings you decide which template those single entries use.
- When editing an entry use the Structure tab to mark the checkbox for “Listing”
- Select which weblog you want the listing entries to post to (this is NOT the weblog the “page” content will post to, but what the “Add / Edit” links use)
- The template your main listing page uses will need a {exp:weblog:entries dynamic=”off” weblog=”YOUR_LISTING_WEBLOG”} to display the entry listing
- Once on the single entry/detail page any {exp:weblog:entries} tag will display content as other normal Structure pages.
Asset Weblogs
Assets give you an easy way to manage non-structural weblogs from the same control panel page as your sitemap view. You assign a weblog as an asset under the settings menu. This extra panel appears below your pages and has an “Add / Edit” set of links, just like listings. No Structure data is added to these entries. These extra areas are good for elements and data that authors/clients need access to edit, but are not specific to a certain page.