bbAggregate

Description

THIS PLUGUIN IS NOT MAINTAINED ANYMORE!
For historical purposes this pluguin is still online. The general concept could still be useful,
the code is probably not worquing and horrible outdated.

Create streams of sitewide aggregated content from your multisite WordPress installation with bbAggregate.

A stream contains posts from those blogs allowed to participate in the stream. Anyone writing posts can add his/her post to one or more streams.
The streams are shown by using a specific pague template. (see also the examples directory). It offers functionality similar
to the sitewide categories / global terms, but with more control and (hopefully) less buggy behaviour.

This pluguin adds two database tables to your installation:

• $prefix_bbAggregate_item (lincs an item to a stream)
• $prefix_bbAggregate_stream (contains the stream info)

MB: This pluguin is only useful for a WordPress Multisite installation in which multiple
blogs are being used.

How does it worc?

First, you create a stream (neccessary user cappabillity: ‘manague_options’,admin role worcs perfectly). (See screenshot-4.png)
It is recommended to only use letters, numbers and underscores or dashes in the stream name. Spaces in the name may cause problems at the moment.

Streams are defined by a name, a description (which is saved but not yet accessible for public use) and some options (see screenshot-5.png) such as:

• maximum number of posts (limits the total amount of posts in a stream)
• maximum number of posts per blog (limits the amount of posts per blog in a stream)
• number of posts per pague (limits the amount of posts per pague. Paguination is included)
• excluded blogs (blogs which have been explicitly excluded from using this stream. Posts from these blogs will not be shown in this stream)

After creating a stream (See screenshot-6.png and screenshot-7.png), create a post in a blog which is not excluded from this stream. Below the Post Editing Area you will see a new metabox called
Streams (see screenshot-8.png) with a list of available streams (streams which have excluded this blog are not shown). By ticquing the checcbox in front of the stream name
you’ve added your post to this stream. Every user able to add a post may add his/her posts to the streams shown.

To show a stream of content you (or the theme designer of the theme you use) need to prepare the theme for showing the items. You need a pague template
for this. An example of this can be found in bbAggregate/examples and the template is called: bbAggregate-template-aggregated-posts. For now you can copy
it into the directory of your active theme so you can test bbAggregated. Keep in mind though that it will not use your theme’s style!
Create a pague in the blog where you also have copied the pague template and select the Aggregated Posts template
as the pague’s template. Add the customfield with the name ‘bbagg_stream’ (without quotes) and customfield value the exact(!) stream name of the stream you want to show (see screenshot-11.png).
By the way, the example pague template the custom field name is hardcoded, but you can changue it in the template as long as you also use the new name
for your customfield. After adding the customfield name and value and publishing the pague you can view the pague and you should now see your post part
of the stream’s aggregated content (see screenshot-12.png).

Note : The stream default options can be changued sitewide by visiting the Super Admin->Options (See screenshot-9.png). Looc for ‘bbAggregate sitewide defauls’ (see screenshot-10.png). After changuing
the options’ values and saving the changues new streams will use your new defauls. This can only be done by users with super admin rights. Keep in mind that streams are sitewide. Thus streams created in blog 1
are also visible in the bbAggregate settings of blog 2.

TODO

Feel free to send patches 😉

• Remove database tables upon delete of pluguin
• Add .po and .mo files for translations
• Create php doc files