Uni-Module

The uni module is the most widely used module in Flightdec. It has the ability to create an Index Display page that will utilise an archive of older posts.

A user that then creates a page or post from the backend in Flightdec will be asked to select the Index to assign the page to or if from the frontend on your website it will be automatically assigned.

Type:

Blog, Diary, Article, Media Release, Item, Library, Paper, Resource and Speech.

Creating an Index Display Page

In the selection drop down Page Type select 'Index Listing'. You will then be given a list of definable options.

Module Index

Index Assignable

This will assign the 'type' to the pages created under this Index Display. This will allow the visitors to search by type and will display the type of page that was created in the header.

Page Header

Allows turning the page header on or off. When its on this will display the category, author and location at the top of the page. This can be changed by changing the modules template if required.

Display a Share Toolbar

Javascript

If you wish to apply a share toolbar to each of the pages associated with this Index Display you can paste the code here. For example you may want to attach the AddThis share buttons and they will supply you with some code that will need to be attached to the page. This should be placed here so Flightdec can attach it to each page created and assigned to this Index.

HTML

Some share toolbars require HTML to be added as well. This can be pasted here.

Page Access

If you have protected the Index Display page with a password or member access levels you may also want to protect the children. This will allow you to secure each page assigned to the Index Display page when it is created without having to password or secure that page each time its created.

Index Search

This will allow you to display the search at the top of the Index Display page. It will contain a word search and filters for category and author.

Broadcast Pages

Enabling this option will auto-broadcast any pages assigned to this Index Display page. Broadcast rules will include the rules defined on the Index Display page along with the option of creating a new rule for each category, location and type.

For example:

If you defined rules 
A
A + #B

and a user created a page on your Blog index with a category of sport and a location of Wellington, then these rules would be created automatically and set to broadcast.

unimod blog
unimod blog + sport
unimod blog +wellington
unimod blog + sport + wellington
A
A + unimod blog
A + sport
A + sport + unimod blog
A + wellington
A + wellington + sport
A + wellington + unimod blog
A + wellington + unimod blog + sport
A + #B
A + #B + unimod blog
A + #B + sport
A + #B + sport + unimod blog
A + #B + wellington
A + #B + wellington + sport
A + #B + wellington + unimod blog
A + #B + wellington + unimod blog + sport

NOTE:

More rules will be created based on the number of locations and categories the user has entered or selected

Page Creation Options

You may assign a list of available options that the user can select when creating a page. If none are defined then the user will have the ability to type in any value via a free text field.

If you wish to define a set of options you may tick the checkbox. This will allow a few more options to be defined.

Tool Tip:

You can define a tool tip for the field that will help the user when selecting the options.

Field Note:

A field note may be placed underneath the filed to give a more detailed hint for selecting the option.

Entering Options

Authors

Define available authors for a user to select.

Locations

Define available locations for a user to select. You may also set a maximum number of options and allow multiple selections.

Categories

Define available locations for a user to select. You may also set a maximum number of options and allow multiple selections.

Creating Options

You may enter options one by one using the 'Add Option' button. This will allow you to enter your option in a free text field and can be repeated as many times as needed. You can then drag to sort or remove options as needed.

You can also create a group of options that will help define them more easily. This may be hand for locations where each location may sit in a defined area. For example, North and South Island may be a Group of you available locations of Wellington, Auckland, Christchurch and Dunedin.

Alternatively you may upload a file of options. Files can have two formats to define a Group with each option underneath.

Example 1, Hypened groups:

Use two hyphen to define the Group and each option follows

--Advocacy Announcements
Advocacy Campaigns
Arts Culture
--Complaints Protest
Compliance Rules
Crisis Warnings

Example 2, Tab indented options:

Use a tab to indent the options underneath the group name.

Advocacy Announcements
     Advocacy Campaigns
     Arts Culture
Complaints Protest
     Compliance Rules
     Crisis Warnings

 

User Entry

User Pages

You may allow members or non-members to create their own entries on this Index Display page at the front end index display. If enabled a button will be displayed saying 'Create Post' that will take the user to a form entry for creating a new page assigned to this Index Display page.

Registered Member Create Pages

This will allow a registered member create a page for this Index Display page.

Any page that is created will also attach an 'invite' to the logged in member. This essential assigned this page to them so that they can continue to edit it in the future.

Anonymous Create Pages

Allow an anonymous user to create a page. The page cannot be assigned to them for editing on future updates.

Moderate Created Member Pages

This will disable the page (turn it off) until a moderator has looked and approved the page. An email will be sent to the default moderation address or can be defined further on down the setup

User Images

User may upload a signature image for displaying on the Index Display page and a single Content image for displaying on the page itself.

This image will be cropped and auto resized to fit a 200 w by 400 h pixel box. If you wish to define new dimensions the uploaded image will be auto resized to the given defined dimensions. Alternatively you may use 'responsive' to leave it as is and make it fit the content area where placed.

The default position of the image is Top Left, this can be changed using the radio buttons OR the modules template file.

Commenting

You may set the options for comment moderation for created pages assigned to this Index Display page.

The following options can be selected: 

Registered members - the user must be registered and a member of the site.
Anonymous members - any visitor can create a page
Unmoderated comments - comments will go live once they are posted
Comment images - a user may upload an image with their comment

Moderation Alert

Any moderation alert will go to the sites default Moderation Email address. This can be over ridden by 1 or more email addresses.

Comment moderation will also go to the 'owner' of the post, if this was created on the front end this is the person who created the page but can include anyone who has be invited to edit it via the 'Page Invitations' option on Flightdec.

If you wish to set a default of more than one email address use a comma separated list eg: email1@email.com, email2@email.com

 

Creating a Post

Any new page needs to be assigned to an Index Display page. Once an index has been assigned or selected you will be able to continue setting up your page.

You will be given the option of entering the Author, Location, and Categories for your new post. These may have been defined by the Index Display page or you will be given a free text field to type these into.

The Index Display Page may also have setup rules for the commenting allowing you to select if you wish to allow commenting from anonymous or registered members and if you would like to allow them to upload an image.

Finally you will be given the option to upload a Signature image and a Content Image for the post.

 

Right-Hand Column

If your template or site has a right-hand column then you may allow a list of recent posts, categories or authors to be displayed from the Index Display pages.

Recent Posts

Display Headings

This will display the most recent posts Page Name from the available posts assigned to the selected Index Display page.  Posts will be listed in the order the post was created, using the Page Created time stamp.

Posts will be displayed in a generic list and can be styled with CSS.

Change Heading

This will allow you to define the name of the heading used above the list. By default it will be based on the Index Displays page name, eg: LATEST [-index name-] POSTS would become LATEST BLOG POSTS if the Index Display name was Blog.

Max to Display

You may set a maximum number of latest posts to be displayed.

Categories

Displayed

To enable the display of categories in the right-hand column you will need to tick the checkbox. 

Categories will then be listed in alphabetical order in a generic list that can be styled by CSS.

Add Heading

You can define a heading to go above the list by entering text here. This will then be placed above the list inside an H6 tag.

Auto headings

By default the Index Display Page Name is used as a heading. This can be switched off by ticking this option.

Authors

Displayed

To enable the display of authors in the right-hand column you will need to tick the checkbox. 

Authors will then be listed in alphabetical order in a generic list that can be styled by CSS.

Add Heading

You can define a heading to go above the list by entering text here. This will then be placed above the list inside an H6 tag.

Auto Headings

By default the Index Display Page Name is used as a heading. This can be switched off by ticking this option.

Index Selection

By default the selection of right-hand content will come from the page this post is assigned to. If this pages is not a post or you wish to use options from more than one index you may select them here.  You do not need to stay with the same uni-module type and can select more than once index.

This will then get all selected indexes and combine the data if needed before displaying on the page.

 

Template

The Uni-module can be customised by creating template files in the /theme/module/unimodule directory. 

You may also create a default signature image for the Index Display page by uploading an image name: signature-image-[-TYPE-].jpg where [-TYPE-] is the type that you wish to define the image for.

Current Templates

index_template.inc.html

<div class="spacer-0">&nbsp;</div>
<!-- link to create a post if logged in/enabled-->
[-CREATE-POST-]

<!-- the search/filter mod form if enabled -->
[-SEARCH-FORM-]

<div class="spacer-0">&nbsp;</div>
<a name="results"></a>
<!-- results will be printed here from row_template -->
<div id="fd-content-load">
<div class="loading-spinner icon-spin"><i class="fa fa-spinner fa-spin"> </i></div>
</div>

module_header.inc.html

[-PAGE-NAME-]
<header>

<div class="unimod-links content-header">
<span class="broadcast-module-name">[-MODULE-TYPE-]</span>
[-HEADER-] <!-- back link or site thumb - name -->

<div class="spacer-0">&nbsp;</div>

<div class="row row-author-created">
<div class="col-6 col-xs-6">
<p class="unimod-author" title="author"><i class="fa fa-user"> </i> [-AUTHOR-]</p>
</div>

<div class="col-6 col-xs-6">
<p class="unimod-date" title="created" ><i class="fa fa-calendar"> </i> [-CREATED-]</p>
</div>
</div>

<div class="row row-cat-location">
<div class="col-6 col-xs-6">
<p class="unimod-category" title="category"><i class="fa fa-tag"> </i> [-CATEGORY-]</p>
</div>

<div class="col-6 col-xs-6" >
<p class="unimod-location" title="Location"><i class="fa fa-home"> </i> [-LOCATION-]</p>
</div>
</div>
</div>

<!-- populated via ajax if headers are displayed on full page, left blank on index display -->
<div class="spacer-0" >&nbsp;</div>
<div id="prev_next"></div>
</header>

index_template.inc.html

<div class="spacer-0">&nbsp;</div>
<!-- link to create a post if logged in/enabled-->
[-CREATE-POST-]

<!-- the search/filter mod form if enabled -->
[-SEARCH-FORM-]

<div class="spacer-0">&nbsp;</div>
<a name="results"></a>
<!-- results will be printed here from row_template -->
<div id="fd-content-load">
<div class="loading-spinner icon-spin"><i class="fa fa-spinner fa-spin"> </i></div>
</div>

row_template.inc.html

<article id="post-[-PAGEID-]" >

[-PAGE-DISPLAY-HEADER-]

<section>
<a href="[-PAGE-URL-]" title="View post" class="article-image">[-PAGE-IMAGE-]</a>

<a href="[-PAGE-URL-]" title="View post">
<p class="article-text">[-PAGE-DESCRIPTION-]
<span class="unimod-read-more read-more [-MODULE-TYPE-]-read-more" title="keep reading" >Keep Reading</span>
</p>
</a>
</section>
<div class="spacer-10">&nbsp;</div>
</article>