Table of Contents
Publishing a Story
Stories (also referred to as articles) are one of the primary content types in glFusion. All stories are associated with at least one topic.
Stories have 2 parts - the Introtext and the Bodytext. Think of the introtext as the teaser, this is the part of the story that will display when viewing the main index page, or a list of stories by topic.
Stories can be thought of as blog entries, news articles, or general announcements. Every story belongs to a Topic.
Stories are generally broken up into two parts, an introduction and the body text. The introduction, or sometimes called the teaser will be displayed on the main index page and if there is a body text portion, a Read more link will be appended to the end of the intro.
There are several general options you can select when publishing your story:
- The title of your story.
- Sub Title
- The sub title can be a more descriptive blurb to help convey the meaning of the story. Sub titles are used as both a presentation tool and for social sharing.
- This is the unique ID that will be used to reference your story via a URL. You can change this to something more descriptive if you wish. The ID cannot be more than 128 characters.
- You can save a draft copy of a story for another user to review or to work on later. As long as it is saved with the Draft box checked, it will not be available for viewing to site members.
When editing your story, you can access the publishing options by clicking the “Publishing Options” link at the top of the screen. You can change:
- You must select a topic for each story. Topics will help categorize your story and also applies the same security controls for the topic to your story.
- Alternate Topic
- Optional - assign a story to an alternative topic. This can be useful to have a story display in more than one topic. For example, here at glFusion.org we have a glFusion topic and a Security topic. If there is an announcement for glFusion CMS that contains security information, we would set the topic to glFusion and the alternate topic to Security.
- Show Topic Icon
- If checked - the topic icon will be displayed at the top of the story text.
- If a story is set to Featured, the story will always displayed before other, non-featured stories.
- Controls if the story should be displayed on the main index page (summary view), optionally how long to display on the index page or if it should only be displayed when viewing the primary or alternate topic.
- Show on Front Page - Always display on the main site index page
- Show Only in Topic - Only display when viewing the specific topics this story belongs to
- Show on Front Page Until - Display on the main site index page until the specified date. This allows you to highlight new stories for a period of time and then have them only view in the topic view once they have rolled off the front page.
Allows you to enable, disable, or close comments for a story.
- Comments Enabled - Allows users to enter comments for the story.
- Comments Disabled - No comments allowed for the story. If comments were enabled, selecting disabled will completely remove the display of comments for the story so no existing comments will be displayed.
- Comments Closed - Prevents any future comments, but will display all existing comments for the story.
- Enable or disable trackback feature for the story.
Publish Story Date
- Defines the date to publish the story. This allows you to enter future dates, which would prevent the story from being published until the date / time has arrived.
- Auto Close Comments
- If checked, comments will automatically close on the date / time specified. This can be useful if you want to leave comments open for only a short period of time and then automatically move to Comments Closed state.
If you publish stories from other sites, you can include the proper attribution information while entering the story. You can specify the original author and website. If you provide the original author in the Attribution fields, this name will replace the local user who published the story.
- Attribution Source URL
- If the story content originated from another site, you can put the source URL here.
- Attribution Source Site Name
- Place the source site name here
- Attribution Author
- Place the original author's name here.
There are several ways to add images to your stories.
- Select / Upload from Images on Server
- Click on the “Images” link at the top of the story editor screen. Use the “Browse” buttons to look for the images on your computer for uploading. The “Images” section of the story editor has more notes on how to integrate the images in your post. You will need to insert the [image1] etc. tags into the story manually.
- WYSIWYG Editor Image Browser
- When using the Advanced WYSIWYG editor, you can select the Image Button to upload and insert images to your story.
- Media Gallery Auto Tags
- If you are using the Media Gallery plugin, you can upload images to a Media Gallery album and include them in your story using the [media:] auto tag. See Media Browser below.
Stories can have an attached story image. The Story Image will be displayed above the story title.
The story image adds a lot of new capabilities. For example, when sharing a story via social media, this image will be used by the social media site. You can have the story image display on the index page, but not when viewing the full story. Or you can have the image display as part of the story. The story image is really beneficial when using the new headlines auto tag.
Stories can also have a video attached. If the Story Image is set, the image will show in the index view (abbreviated view) and will be used as the cover image for the video which will be available in the full story view. You can set a video to auto play on display.
The archive options allow you to set whether the story will be archived or deleted on a particular date. The default is for no archiving or deleting. To change the setting, click on the “Archive Options” link and make the desired changes.
Permissions indicate who is allowed to read and edit the story. The default is that anyone can read the story, and only the owner can edit it.
The possible permission options are:
- Anonymous visitors (not logged-in) - read-access on or off
- Members (must be logged-in) - read-access on or off
- Group members (must be logged-in) - read-access on or off; edit-access on or off
- Owner (must be logged-in) - read-access on or off; edit-access on or off
To allow only members to read the story, un-select the check-box under “Anonymous”. Members must log into the site before they can read the story.
To prevent members from reading the story (i.e. if you have a story about creating a user-account and don't want it to show once they have logged in), de-select the check-box under “Members”.
glFusion also has permissions set by groups. By default, the Admin account and any account with Root access is a member of all groups except Remote Users. Members can also be assigned selectively to individual groups (i.e. “Story Admin”). By changing the group showing in the drop-down box and selecting the check-box “E” under “Groups”, you will allow anyone in the selected group to be able to edit the story.
You will want to retain read and edit access to your story. De-selecting those options does not seem to remove your read and edit access, but you are advised against changing that because you may lock yourself out of the story.
Advanced Editor (WYSIWYG)
The best method to edit and modify stories on your glFusion site is to use the Advanced Editor (CKEditor). This gives you a true WYSIWYG editor. It allows you to easily format your stories using a variety of font styles, bullets, images, etc.
Video Embed Plugin
This plugin allows you to easily insert embedded videos into your stories. Simply choose the XX video embed icon and the following window will pop-up. Simply paste the embed code you received from YouTube or your favorite video hosting site and you are done!
Media Gallery Media Browser is a plugin for the FCKeditor that is included with glFusion. This plugin will allow you to easily insert Media Gallery autotags into your stories and static pages. In the editor screen, simply press the MG button on your editor toolbar to open the Media Browser. Select the type of autotag, attribute, and the media item, press INSERT and the autotag will be placed in the editor window.
The Global Story Editor allows you to set specific attributes for a large group of stories (either all stories or for stories in a specific topic). The following attributes can be modified:
- Display - Show on Front page or show only in topic
- Comments - Enable, disable or close comments
- Trackbacks - Enable / Disable trackbacks
- Owner - Set owner of the story
- Group - Set group owner of the story
- Show Topic Icon - Set whether the topic icon will be displayed or not
The Global Editor also allows you to move a batch of stories from one topic to another.
Globally Changing a Setting
Global changes can be applied to all stories or to stories in a specific topic. Select the scope of the change from the [b]Filter By Topic[/b] drop down.
Once a topic or all has been selected, you must select the checkbox in the Update column to enable the global change. Once you select the Update checkbox, then select the appropriate setting from the Value column.
Click [b]Save[/b] to execute the change. You will be presented with a “Double Confirmation” prompt, first asking if you are sure, and a second validation prompt again asking for confirmation. The double confirmation is the safety gate to prevent accidental changes.
Moving Stories from one topic to another (glFusion v1.6.5+)
You can quickly move all stories from one topic to another topic. To move a stories, you must select the source topic by selecting the topic from the Filter By Topic dropdown.
Next you must select the destination topic by selecting the topic from the Move to New Topic dropdown. Note that any featured story attribute for all stories in the source topic will be removed.
Once you have select the source and destination topics, click Save to execute the change. You will be presented with a “Double Confirmation” prompt, first asking if you are sure, and a second validation prompt again asking for confirmation. The double confirmation is the safety gate to prevent accidental changes.