Managing Items

From GregariusWiki

Navigate to this screen by clicking the small pencil/paper icon next to each item's title.

An item from a RSS feed has the following states:

• Read: If you have read it.
• Unread: If it has not been read yet.
• Sticky: An item with the Sticky flag set will never be deleted when you prune items, unless you explicitly specify it. This is useful when you want to clean your database but would like to keep a set of items that specifically interest you.
• Flag: An item which is Flagged can be viewed for later reading, but will be deleted when items are pruned.
• Private: A private item will simply be invisible to the visitors of your Gregarius installation: basically only you get to see private items! In fact you probably won’t set the private flag on individual news items, but rather on a whole RSS feed (which is done in the feed management section of your Gregarius’ administration area.) Setting the private flag on a feed will set this flag on all past, present and future items of that feed; removing the private flag from a feed will set all the items of that feed to be public again.

How are these flags set on items you ask? Well, its rather trivial:

1. . When you log into the administration area of your Gregarius installation you are given a cookie, which will identify you as an administrator (and will grant you the right to see private items!)
2. . When you come back to the content sections of your Gregarius installation you will notice a new edit icon (the edit icon) next to you items’ permalink icons.
3. . Clicking that very icon will expand a tiny inline dialog, where you can toggle the item flags.
4. . When you are done setting flags clicking ‘OK’ will post you edits back to the server via AJAX and collapse the dialog.

Viewing Sticky and Flagged Items

• To view items which are flagged as "Sticky" or "Flag," enable the StickyFlag plugin. Edit preferences to reveal a "Sticky" or "Flagged" button in the top navigation, or to include a shortcut in each story's headline.

[edit] Pruning Items

Use the prune feature to remove old items from the database.

To delete old items, use the Prune feature (under Admin > Items) to clean your database.

There is an error in version 0.5.4 and before where the prune feature does not work if the data set is too large (see this forum thread). You'll need to manually prune items with a database query. For example, to prune all items earlier than '2007-07-23', use the query:

DELETE FROM item WHERE added < '2007-07-23'