Add a browseable, flexible directory of the sites in a WP Multisite network. Each subsite gets its own page.
Screenshots
Multisite Directory adds a "Categories" entry to your Sites menu so you can organize your sites using the familiar Category interface.
Site categories include geotagging capabilities out-of-the-box, so you can easily group your sites by geographic region.
The plugin includes a Network Directory Widget as well as a shortcode ([site-directory]
) that make it easy to publish a simple Multisite Network Directory in a post, page, or widget area.
When users create new sites, they can categorize their blog under the scheme you created. Once their site is created, however, the Super Admin can always re-categorize the new site at will.
FAQ
Installation Instructions
Multisite Directory is for WordPress Multisite installations only. Do not use this plugin for single-site installs.
To manually install Multisite Directory:
- Upload the unzipped
multisite-directory.zip
file to the /wp-content/plugins/
directory.
- Activate the plugin through the ‘Plugins’ menu in WordPress
- Customize your site directory in the main site’s Dashboard.
How do I customize the directory?
Edit your theme’s templates! 🙂 This plugin makes no assumptions about the look-and-feel of your directory so that any theme that wants to can customize it. You only need to customize your theme if you want to change the default appearance.
As a Theme author, you will probably want to create at least two new files:
archive-network_directory.php
taxonomy-subsite_category.php
The archive-*
page is the main directory page. It will list all the sites in your multisite network. The taxonomy-*.php
page will list a subset of the sites in your network based on their categorization. You can customize these files as you would any other theme file.
If you do not create these files, then the default WordPress template hierarchy will take over, meaning that either the archive.php
or index.php
template file in your main site’s currently active theme will be used to display the network directory itself and one of taxonomy.php
or index.php
will be used to display a filtered view of your directory’s categories.
How do I customize the map’s popups?
By default, when you click on a pin in the directory’s map view, you’ll see a list of links to the categorized subsites in your network, along with their site logo (if they have one). Most themes do not come with custom styles for map popups, so to customize their look and feel to match your site, you will need to write CSS to define a presentation for the lists yourself.
ChangeLog
0.2.3
- Updated translations and numerous compatibility improvements (props @hvianna).
- Protect against errors when mistakenly activated on a single-site WordPress install.
- Enhancement:
get_site_permalink()
now supports the scheme
parameter of get_site_url()
.
- Feature: Choose to keep Directory Entry titles in sync with Site Name changes.
- Bugfix: Fix bug where shortcode was always printed above post content.
0.2.2
- Adds
custom-fields
support to Site Directory entries.
- Adds contextual help on the Site Directory post edit screen.
0.2.1
- Feature: Shortcake UI integration. (You must have the Shortcode UI plugin activated for this to work. Props @misfit.)
- Developer: You can now programmatically remove the geolocation interface from the Subsite Category admin pages. Use code such as
remove_action('subsite_category_edit_form_fields', array('Multisite_Directory_Taxonomy', 'edit_form_fields));
from a plugin or theme to do so.
0.2
- Feature: New shortcode argument
query_args
accepts a JSON string to pass to get_posts()
.
- Bugfix: Remove front matter from rewrite rules.
- Note that this changes your permalink structure. If the network directory posts on your site are not showing up after you update, be sure to visit your Permalink settings screen and click “Save Changes” (without making any changes) to force a refresh.
- Numerous bugfixes.
0.1.2
- Bugfix: “Remove location” button on taxonomy edit screen correctly deletes term geolocation metadata.
0.1.1
- Bugfix: Fix PHP warning when no attributes are passed to the shortcode.
0.1