Super Category (multi-blog) plugin – V 0.8

April 2, 2007 by aaron

Unfortunately this is only for WordPress 2.1

The Super Category plugin allows you to have multiple websites running off of one install and one database (one set of tables). The websites can share content if you wish it, and can have different titles, descriptions and themes. This plugin is a true plugin: there are NO HACKS and NO THEME EDITS of any kind. The plugin works with any other plugins and themes that use WordPress’ built in APIs, and features modular functions that can even make other plugins that use custom queries work also.

If you find a problem with the plugin please let me know what happened using as much detail as possible. Unfortunately, I cannot currently ensure every plugin works with this plugin, so please let me know which ones don’t work. I will try to have a fix within a few weeks.

Download Super Category (multi-blog) plugin – V 0.8

Known Issues

Unfortunately wp_list_archives does not work with the plugin because WordPress does not allow us to filter months with posts from other Super Categories, so you will get a lot of empty archives. However, if you have posts in the same months on all sites then this doesn’t effect you.

There are likely to be other issues, so please activate this first on a test site. While I have made it easy to activate and deactivate, there may be complications. If you deactivate it, you will manually have to delete the super category (this will not delete child categories), and all settings should go back to the defaults.

Installation:

  • Read section entitled “Parking Domains” — if you know what a parked domain is AND can park them, you can skip this part.
  • Download Plugin
  • Read all instructions–I’m a good writer, so it won’t be too much of a chore.
  • Upload super_cat.php to wp-content/plugins/
  • Activate Plugin
  • Follow instructions that you previously read.
  • Bask in the glory of the easiest, best, most advanced and most convenient multiblog in the history of WordPress.
  • Send a donation with a number greater than 0 (preferably followed by lots of zeros to the right of the decimal place to me) or rabid monkeys will eat your slippers. I Assume That…

  • You have access to virtual sub-domains or parked domains, or know how to forward all requests to a single file.

  • You have at least a mid-level working knowledge of how wordpress displays information.

  • You are using a clean install, or that any pre-existing categories and links you want part of one site. If this is not true it is not difficult to change it later.

  • You want all the same options and activated plugins on all sites. Currently you can have separate blog titles, descriptions, themes, posts, categories, pages, links, and feeds. Everything but basically.

  • You want any pre-existing pages on your blog to be available to all blogs. Again if this is not true it is easy to change.

  • You use themes that use fairly normal methods to display categories, links, posts, etc. Themes that don’t use the api’s provided and actually touch the database won’t allow the filters to filter. These themes may need to be edited.

  • The same goes for plugins.

  • You will read all of the instructions–yah right.

  • How To Use It.

    • The Super Category that you will be using is your site URL. This includes the subdomain and the top-level domain. So for example, http://www.mail.google.com would have a Super Category of ‘mail.google.com’, http://anthologyoi.dev would have a Super Category of anthologyoi.com
    • The basic idea of this plugin is that anything that can be designated for a single site is added to a Super Category. Super Categories are designated for categories and pages. You may then add other pages and categories to those Super Categories by making them children.
    • Parent categories and pages will function as normal except for when they are Super Categories.
    • Links and Posts can be added to the categories as normal.
    • To have pages visible on all sites do not add them to a Super Category. To have links and posts on multiple sites just select categories with different Super Categories.
    • You can have as many sites and super categories, and no matter how you add posts or pages your readers will never know there are multiple sites.
    • Posts and links SHOULD NEVER be added directly to Super Categories
    • The Super Category management page you can change the blog title, description or theme for each Super Category. You can also add them.

    Integration

    I have tried to make it easy to expand Super Categories to work with other plugins and options allowing people to fit this plugin to their needs. While I could have left it up to the plugin developers to “fix” their plugins, I thought the best way to implement this is to make integration so easy that developers and users alike had little reason not to. However, this section is still in the works, so it may not work all the time.

    Assuming the plugin only needs to use a basic filter structure. You can use the sprcat_option_filters(‘optionname’) function to automatically create a basic filter and filter function (direct replacement of the default database value with one from the Super Category).

    The filter sprcat_get_options should be used to add menu items to the Super Category edit page. The filter passes the current mode (either add or edit), the current option value array and the correct super category name that the option will be used for; all of the passed values are required as add and edit modes require different naming conventions, the set option values are important, and the super category name is required to process the option..

    Ensure that you return the options as a two column row

    ADD ROW: <tr><td>Option Description</td><td><input type=“text” value=“” name=“sprcat_new[option_name]“/></td></tr>

    EDIT ROW:

    <tr><td>Option Description</td><td><input type="text" value="$sprcat[option_name]" name="sprcat[$spr_cat][option_name]"/></td>
    </tr>
    

    Parking Domains

    This is not a How-To guide for parking domains; instead it is meant to be just a brief introduction and explanation of what you will need to be able to do to use this plugin. Without parked domains this plugin is almost worthless (although there are some useful traits) so make sure you can use them before you install the plugin.

    First of all to park a domain you need a minimum of two domains. A parked domain is a domain that points to the EXACT same place as another domain without using frames or redirections. It is not an add-on domain which points to a sub-folder. You may not be able to park domains depending on your hosting company; if you can’t you must either switch companies or convince your companies to allow you to park domains. Occasionally, a hosting company may refer to parked domains as aliased domains or one of several other names. If the domain name can point to the same folder as another domain name it will work no matter what the name is.

    Secondly, you must make sure that the parked domains are registered with valid name servers and have propagated through the DNS before adding them to this plugin. While there will be no obvious errors if you try to do it before hand, none of the options will work until the domain is fully propagated.

    Categorized as:
    comments powered by Disqus