Problem:
We have several different sites that are powered by one Movable Type install. These sites have common elements that need to be shared across all of the blogs—something like services, staff or course descriptions. Unlike global template modules, these shared items have lots of meta (like categories, tags, etc) and really need the framework a blog provides. Not every one of our sites have the same services, staff or courses, so they need to be able to specify which resources get pulled from the pool.
More importantly, perhaps, is the fact that each of these items in our shared library need to live within the chrome and the url structure of the individual sites. In other words, the course that Site A is offering is the same as Site B, but we need to make sure the course description lives at http://examplesite-a.com
and http://examplesite-b.com
respectively along and has each site’s correspondent branding and layout.
Solution:
Here’s the gist of our solution. We create a shared blog and then pull those shared pages or entries into each individual blog using private tags as a filter. They’re fed into a php switch statement that checks against a query string and serves up these shared resources based on which is identified in the url. The end result will look something like http://examplesite-a.com/courses/?course=microsoft_word
. A little confusing at first, but it will make more sense as we start building it out.
First, create this “shared blog” within the system. Make note of the blog’s id. Publishing settings won’t matter too much because this is really just storing data for the other sites to pull from. In fact, you can save yourself some unnecessary rebuilding and delete all the templates in this shared blog.
Go ahead and add some pages to this shared blog. For this example, I’ll be creating a pool of courses, each with a course title (title), course description (entry body) and course category (category).
Next, in the individual blog where you’re pulling from this shared library, create an index template with the following code (obviously replacing the chrome header and footer with whatever standard code you’ve got before and after the main page content):
<!-- CHROME HEADER -->
<mt:Var name="this_blog_tag" value="@sitea">
<?php
if (array_key_exists('course', $_GET)) {
$coursename = $_GET[course];
switch ($coursename) {
<mt:Pages blog_ids="###" tag="$this_blog_tag OR @ALL" no_folder="1" sort_by="title" sort_order="ascend">
case "<mt:PageBasename>": ?>
<div class="course">
<h1 id="page-title" class="asset-name"><mt:PageTitle></h1>
<mt:PageBody>
<mt:PageMore>
</div>
</mt:Pages>
<?php
default:
echo "Not A Valid Course.";
}
} else {
echo "No Course Selected.";
}
?>
<!-- CHROME FOOTER -->
You can publish the output file whatever you want, but make sure it’s a .php file. For this example, I’m using courses/index.php
. That will publish this file to http://examplesite-a.com/courses/index.php.
Now, let’s break down this script. First, we’re creating a variable called this_blog_tag
. Setting a variable here lets us define this particular site’s private tag (more on that in a moment) in a module that gets included in the header of this particular blog. That way the rest of the code can be moved into a global module if you want and it will still filter correctly on a per blog basis. If you don’t understand that part, don’t worry—you don’t need it to get this working.
Next, we’re checking to see if any course was specified in the query string. If not, the script dumps out a “No Course Selected” message, but that’s probably not likely to get seen because we’re going to let MT build the urls. If something is specified in the query string, we run in through a PHP switch
statement.
Essentially, MT is providing PHP with all of the different valid “cases” that this query string could be and filling out the content for each of those “pages”. Notice the mt:Pages
loop. Every page from your shared blog (be sure to replace ### with the blog id of the shared blog) that is tagged with this site’s tag (e.g. @sitea) gets a case statement. PHP compares the query string (e.g. ?course=microsoft_word) with the basename of the page. If they match, that page’s content is served up; if not, an error message is displayed.
Ok, the heavy code part done. Let’s see what all this means practically.
We type in the url http://examplesite-a.com/courses/?course=microsoft_word
. The index.php
page in our courses folder then checks to see if microsoft_word
is a valid case. Since the basename for our Microsoft Word page on the shared blog is microsoft_word
and since we’ve tagged that page with @sitea, it works! If that particular page wasn’t tagged with @sitea or @ALL, MT wouldn’t build in a case for it into this site’s PHP.
So how do we use this with our site? I could, for instance, put a “Courses Offered” sidebar module that looked something like this:
<h3 class="widget-header">Site A Courses Offered</h3>
<ul class="widget-list">
<mt:Pages blog_ids="###" tag="@sitea OR @ALL" no_folder="1" sort_by="title" sort_order="ascend">
<li><a href="<mt:BlogURL>courses/?course=<mt:PageBasename>"><mt:PageTitle></a></li>
</mt:Pages>
</ul>
Notice the url we’re building: <mt:BlogURL>courses/?course=<mt:PageBasename>
. We’re just passing the basename to that one course page, and that PHP magic we created knows which to serve up. Now we have one course (along with it’s description, title, category and whatever other custom fields we want to create) that can be pulled into as many sites as we want while still retaining that site’s url structure and branding.
Note: If you don’t like query strings, you can always put something like this in an .htaccess file to clean up your url:
RewriteCond %{REQUEST_URI} ^/services
RewriteRule ^(.*)$ /services.php?service=$1 [L,QSA]
That lets us use cleaner permalinks for our courses, like <mt:BlogURL>courses/<mt:PageBasename>
.