About this plugin
Multisite Directory provides a customizable Network-wide site directory for WordPress Multisite installations. You can categorize subsites in your Network, add full-length descriptions and featured images to them, and more. Theme developers can customize the look and feel of the site directory using all the tools they’re already familiar with.
Blog authors can use a highly-configurable shortcode ( [site-directory] ) to display the directory anywhere shortcodes are supported.
Each time a new site or blog is added to your Network, a corresponding entry in the site directory is added, too. The directory is managed from the Network’s main site, but most changes to the subsites (other blogs) automatically update the directory. Many parts of a given site’s appearance in the directory can be modified without affecting the site itself.
This means a Super Admin can use a custom site logo, tagline, and so on in the directory itself, without changing the site’s actual logo, tagline, and so on. Additional options in the Network Settings → Network Directory section allows Super Admins to tweak the bells and whisltes, such as keeping Directory Entry titles in sync with Site Name changes.
Site directory entries are implemented as a hierarchical custom post type in the main site. These pages can be categorized with a custom subsite_category taxonomy. We’ve found that this combination allows maximum flexibility while providing the tightest integration with existing WordPress core features.
As a result, no new tables are added to your install, and no side effects are introduced. (TM)
Quickstart guide
After installing the plugin, you’ll want to:
- As a Super Admin, go to My Sites → Network Admin → Sites. Notice the new “Categories” link on the sidebar.
- Create some categories! If the category relates to a location (maybe it’s a site for a regional chapter of your organization?), be sure to click the map to geotag it.
- Click on “Directory,” immediately above “Categories.” These pages are the individual directory entries, not the blogs. Categorize these pages as you would regular WordPress Pages to organize your Site Directory.
- Go to any site’s Appearance → Widgets screen, and add a “Network Directory Widget” to a widget area.
- If you’ve geotagged some of your Site Categories, choose “Display as map” from the widget options. (Otherwise, leave it on “Display as list.”)
- Click Save, view your blog, and enjoy your new Site Directory!
Check out the Screenshots for a few examples.
This plugin provides a number of functions to Theme authors so that they can make use of the Multisite Network Directory features in their themes. This section documents those functions. php file.
get_site_directory_terms
Gets all categories in the site directory.
- @return array|false|WP_Error
Get site terms
Gets the categories assigned to a given blog in the network directory.
- @param int $blog_id
- @return array|false|WP_Error
the_site_directory_logo
Prints the site’s custom logo or the site directory entry’s featured image, if it has one.
- @param int $blog_id Optional. The ID of the site whose logo to get. Default is the current directory entry’s site’s logo.
- @param string|int[] $size
- @param string|string[] $attr
- @return void