next up previous
Next: 3.3 Users Up: 3 Administration Previous: 3.1 Comments

Subsections


3.2 Stories

Stories (or articles) provide the main visible structure to a scoop site. Typically, they introduce an idea for discussion, which then takes place in the attached comments.


3.2.1 Usage

Posting stories is mostly taken care of by the readers, in the story moderation queue. Stories are either posted to section or front page, or they are hidden, based on how the readers have voted.

Stories are accessed for administration either through the [edit] link placed in the story header or through the story list in the admin box. Clicking the [edit] link in a story header takes you directly to the story editing page; clicking the story title in the story list takes you to the story editing page; clicking the [Read] link next to the title in the story list takes you to the story display page; clicking the [Delete] link in the story list deletes the story.

Stories are completely editable by people with the appropriate permissions (story_admin), and is almost identical to posting a story, but with a few differences.

In addition to modifying the text, there are two special strings, ``[ED]'' and ``[UPDATE]'', which will be changed into ``[editor's note, by <user>]'' and ``Update [<date> by <user>]'', respectivly. These are allowed in both the intro- and body-text.

There is a 'Set timestamp to now', which also has the effect of putting the story at the top of the page, if it's been posted already.

There is a drop-box with the options 'Submitted', 'Never Display', 'Always Display', and 'Only Display Within Section', which control where the story appears. 'Submitted' means that it is still in moderation and it is only displayed in the moderation queue, 'Never Display' means that it is hidden and is only shown in the story list, 'Always Display' means that it is displayed on the front page, and 'Only Display Within Section' means that it is displayed on the section page but not the front page. The latter three are used by the system when the votes reach the thresholds for '-1 Dump it', '+1 Front Page', and '+1 Section' votes, respectively. They can also be manually set to bypass voting.

Before that drop-box, and after it, there are two others. One has 'Submitted', 'Pending', and 'Normal', while the other has 'Comments Disabled', 'Comments Enabled', and 'Read-Only'. While changing these does update the story and change those values, the values themselves are unused. Basically, neither of those drop-boxes have any effect.

Rather than only the 'Post' and 'Preview' buttons which are used in normal story submission, there are 'Update', 'Save', 'Preview', and 'Delete'. 'Preview' and 'Delete' do what you would expect them to do, 'Update' saves any changes you have made and returns you to the story edit form, and 'Save' saves changes and displays the story without the story edit form.

The rest of the form is just like the standard story submission form, including the poll editing form.


3.2.2 Notes

None


3.2.3 Relevant Vars

Everything in the 'Stories' category of site controls.


3.2.4 Relevant Perms

Group permissionsstory_admin, story_post, story_list, moderate
Section permissionspost_stories, read_stories


next up previous
Next: 3.3 Users Up: 3 Administration Previous: 3.1 Comments