Content Basics

Page Templates

Page templates are used to change the layout and function of a page. When editing a page, you can use the Page Attributes > Templates menu (in the righthand sidebar) to choose which of the following templates will be used to render the page.

• Default Template
• Caucuses List - lists all Caucuses alongside the page content
• Committees List - lists all Committees alongside the page content
• District - page-district.php
• Districts List - displays a searchable table of Members/Districts alongside the page content
• Image Header - the page title is displayed over its Featured Image as a full-width background
• Page with Sidebar - displays the sidebar widgets alongside the page content
• Raw HTML, Full-width, No Header - a blank template for hand-coding a custom layout

Note: Child themes have their own page templates and disable some from the parent theme.

Excerpts

The theme add support for excerpts on pages (not just posts). Page (and custom post type) templates use the excerpt as a subheading below the page title.

Font Size Classes

Choose the appropriate tags to add hierarchy to your content. Do not choose a tag by the way it looks (i.e. its size). To change the visual appearance of a heading or paragraph, there are custom classes you can add to the tag:

• header-xxlarge - looks like h1
• header-xlarge - looks like h2
• header-large - looks like h3
• header-medium - looks like h4
• header-small - looks like h5
• header-tiny - looks like h6
• text-xxlarge
• text-xlarge
• text-large
• text-medium
• text-small
• text-tiny

<h6 class="header-xlarge">This H6 styled like H2</h6>

<p class="text-large">This is a large paragraph.</p>

<ul class="text-small">
  <li>First item in small list</li>
  <li>Second small item</li>
  <li>Third small item</li>
</ul>

Foundation Components

Many components in the Foundation for Sites framework can be used in the content. Here are some that may be helpful:

• Tooltips - display extended information for a term or action
• Buttons - turn a link into a button
• Visibility Classes - show or hide elements based on screen size
• Grid - responsive layouts
• Callouts - a box to contain information
• Tables - display tabular data
• Tabs - navigate multiple pieces of content in a single container
• Flex Video - ensure the correct aspect ratio of videos on all devices (Note: If the src of the iframe is YouTube or Vimeo, a container with the appropriate classes is added dynamically. So you only need to include the <iframe> tag.)
• Labels - highlight a piece of metadata

Social Media Share Images

When a Council URL is shared on Facebook or Twitter, a preview is generated for that URL with an image, title, and description. The <meta> tags which determine this content are defined in wp-nycc/assets/functions/social-meta.php.

The conditions for which image is used are as follows:

• If a featured image is set for the content being shared, that image is used.
• If no featured image is set, and the content is from a Member site, the Member's front page image is used.
• Otherwise, fallback image (wp-nycc/assets/images/social-img-1024x512.jpg) is used. This fallback image is overridden within certain child themes.

Comments Disabled

This package includes a must-use plugin (wp-content/mu-plugins/disable-comments-mu.php) which completely disables comments for the entire WordPress network. Updates for this plugin may be found at disable-comments-mu.