glFusion Wiki

Site Tools


glfusion:story

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.

General Options

There are several general options you can select when publishing your story:

Title
The title of your story.
ID
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.
Topic
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
Stories can be associated to an alternate topic (optional). This allows a story to be displayed in both the primary topic listing and the alternate topic listing.
Show Topic Icon
Determines whether the topic icon will be displayed at the beginning of your story.
Draft
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.
Post Mode
Determines if the story will be HTML or plain text.

Publish Options

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:

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.
Topic
Assigns the story to a primary topic.
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.
Draft
If checked, the story is saved in draft mode, which means it is not published and is not viewable to anyone other than Story Admins / root users.
Show Topic Icon
If checked - the topic icon will be displayed at the top of the story text.
Featured
If a story is set to Featured, the story will always displayed before other, non-featured stories.
Display
Controls if the story should be displayed on the main index page (summary view) or if it should only be displayed when viewing the primary or alternate topic.
Comments
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.
Trackback
Enable or disable trackback feature for the story.
Rating
Displays the current rating for the story. You can select Reset Rating to erase all existing rating data.

Publish Story Date

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.

Attribution

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.

Images

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.

Archive Options

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

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 Browser

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.


Global Editor

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.

glfusion/story.txt · Last modified: 2017/03/10 10:12 (external edit)

Page Tools