Documentation

Pages vs Posts

The way things are set up now, most sections of the site will be populated with pages instead of posts. The main exception is “News”, which because of its chronological nature makes more sense as a category full of posts.

Part of what we will be looking at as you get content into the system is whether other sections should also be posts instead of pages.

Tagging special posts

The three “Spotlight” locations on the home page are populated with posts that have special tags. For a post to be displayed in one of these areas, it must have a featured image (added in the “Featured Image” box on the post creation page). The newest post with the appropriate tag will be pulled into that location. This makes it easy to quickly feature new items, but it does mean that if you want to feature an older item, you might have to go through your older posts to remove the tag. Just something to be aware of.

The tags for each position follow the name of the position:

  • Individual Spotlight: individual-spotlight
  • Community Spotlight: community-spotlight
  • Partner Spotlight: partner-spotlight

There will likely be other tags introduced to populate specific areas of the site as we flesh out the content.

Custom Post Types

WordPress has the concept of custom post types, which gives you some options for customization that you don’t have with regular posts. We have created two different custom post types for the ABI site.

Upcoming Events

The name of the event should be the title. Description, map, directions, locations specifics, etc. should all be in the main content.

There are two special fields: Event Type and Event Location. These are intended to be somewhat broad, not too specific. Type should be things like “Meet Up”, “Conference”, etc. Location should be city, or maybe neighborhood. The specifics of the location should be saved for the main content. You can add as many locations and types as necessary.

These entries are only for the events themselves, not for reports or recaps. Those kinds of posts should go in the News category, maybe under a subcategory. That’s one of the decisions that we could look at while the content is going in.

Impact Statements

The impact statements are all similar, but appear in three places with three different treatments:

  1. In the green bar above the banner on the homepage, with an image.

    To place an impact statment on the homepage, tag it “home-feature”. The image should be selected as the posts “feature image”.

  2. In the green bar above the banner on all the other pages of the site, no image, randomly selected at page load.

    These should be short. If it’s a quote it should be, the quote itself should be one paragraph and the attribution should be a second paragraph with the class “attribution”.

  3. In the page header of the Get Involved page, with an image.

    To place an impact statement here, tag it “involved-feature”. As with the hompage impact statement, the image should be place in the “featured image” field.

Menus, Sidebars, and Widgets

We are using a plugin called “Simple Page Sidebars” to make it easier to attach specific sidebars to different sections of the site. As you enter the content, you’ll see that not all sidebars or widgets have been created. Again, this is part of the content-hole-plugging process.

Partner Logos

Partner logos are simply uploaded to the WordPress Media Library. Each one should be tagged with the appropriate level, using the singular version. The current tags that are set up for the “Our Partners” page are “visionary-partner”, “strategic-partner”, “growth-partner”, and “affiliate-partner”. To place a list of the sponsors on any page, use the WordPress shortcode for the Media Tags plug-in, like this:

[media-tags media_tags='visionary-partner' size='partner-logo-small' before_list='<ul class="partner-list">']

This will create an unordered list of just the logos with the class “partner-list”. By default that class will put the images side-by-side to fill whatever container they’re in.

If you want to create a full page and/or post for a sponsor (as in a profile), that should be a separate entity in the system. You can use the logo uploaded following the steps above, because it will be in the media library.