A4E Site Documentation

This is a “cheat-sheet” of the various components used for managing the A4E site.

Please read this section thoroughly before beginning any site content management.

Custom Fields:
The following custom fields are used when editing a PAGE. Please note that only those custom fields listed below belong to this site. Other custom fields exist in the custom field listing box, but those custom fields are created and used by 3rd party plugins for the site and should not be edited or used in any way.

  • top-menu – Set this to yes in order to have a page appear within the top menu and flyout structure.
  • is-photo-display-page – set to yes. For use on the Album Display page only. The Album Display page displays the individual photos from the albums displayed on the PHOTOS page.
  • display-event-id – For individual EVENT pages – set this to the event id displayed in the custom CMS area when creating/editing an event.
  • menu-placeholder – Set this to yes in order to have a PAGE appear in the flyout menu, but NOT be clickable. In other words, the menu item acts as a simple placeholder for child menu items that will appear beneath it.
  • flyout-title – Set this to the alternative page title you would like to have appear on the flyout menu for the designated PAGE.
  • alt-title – Normally a PAGE displays its page title (the text at the top of the WordPress editor screen while editing a PAGE). To show an alternate title, set alt-title to the alternate title.
  • staff-development-title. The alternate title to display on the STAFF page for the DEVELOPMENT section.]
  • staff-finance-title. The alternate title to display on the STAFF page for the FINANCE section.
  • staff-executive-title. The alternate title to display on the STAFF page for the EXECUTIVE section.
  • staff-programs-title. The alternate title to display on the STAFF page for the PROGRMS section.
  • blog-landingpage-subtitle. The subtitle that is to appear in the blog pages header.
  • widget-ids – The comma delimited list of widget IDs to display on the sidebar of the PAGE. The widgets will appear in the order designated.
  • hide-sidebar – When set to yes, no sidebar will be displayed on the PAGE. (Not necessary for the homepage)
  • history-image-attachment-id – This is specifically for the HISTORY page. Set this to the image to be used as the “year ruler” background image for the page. To do this, first upload the image to the MEDIA section. Once uploaded, choose the ‘edit’ option for the image and you will see the permalink to the image containing the “attachment_id” as part of the permalink address. Use that numeric value as the history-image-attachment-id custom field value when editing the history PAGE.
  • youtube-channel-url – required. For use on the VIDEOS page – sets the video channel URL address for the desired channel. For example: http://www.youtube.com/user/apple
  • youtube-default-tab – optional. For use on the VIDEOS page – sets the default tab to display when displaying videos. The available options are uploads, playlists and featured. (default if not specified = playlists).
  • youtube-playlist-url – optional. For use on the VIDEOS page – sets the video URL of a particular playlist.

Managing the NEWS, WORK, IMPACT and MISSION pages
To manage the content for the NEWS, WORK, IMPACT and MISSIONS page, special custom CMS pages have been developed that will allow the admin to manage the content. To create the actual PAGES that will appear, use the WordPress CMS to create the PAGE, and assign it the usual A4E Page Template, then set one of the 3 custom fields listed below to yes depending on the page you are creating:

  • is-news-page
  • is-mission-page
  • is-work-page
  • is-impact-page

Custom Styling
In order to perform certain styling on content, from within the WordPress editor, dropdown the “Format” menu item, then from that listing, dropdown the “Formats” menu item. A listing of various styles will be presented to you.

  • icon-bullet-item – this will wrap your text in an inline <span> that displays the pencil to the left of the selected text.
  • h3-board – this is primarily for use on the Board of Directors page to set the equivalent of <h3> text (such as BOARD CHAIR, VICE-CHAIR, IMMEDIATE PAST CHAIR, etc), but can be used on any text on any PAGE.

Custom Formatting
In order to achieve the look shown on the PROGRAMS page, where the pencil bullet points are to the left of all the text and the text wraps indented across several lines, first enter in all the desired text, then choose the “Text” mode from the WordPress editor and wrap the desired text in an <article class=”icon-bullet-item”> and closing </article> tag.

Custom CMS Area
Much of the site content can be managed by simply using the WordPress Content Management System, but certain areas of the site are managed by using the custom CMS area. You can access the Custom CMS area by choosing the “A4E Custom CMS” link in the upper left corner of the WordPress Content Management Area. Be sure to visit that area and to review all CMS screens available to you before you begin editing the A4E site.

Short Codes
Short Codes are small (just a word or couple words) text contained in brackets, that are inserted into PAGE content via the WordPress editor, which then get replaced with actual content at display time. For example: [this-is-a-short-code]

Below are the short codes available for you to use anywhere within a PAGE content by placing therm where you wish them to appear, using the WordPress editor:

  • [staff-gallery-executive]
    This will display the Executive Staff content that you created in the custom CMS area.
  • [staff-gallery-programs], [staff-gallery-finance] and [staff-gallery-development]
    These will each display their respective galleries just as the [staff-gallery-executive] did.
  • [emeritus-board]
    This will display the BOARD EMERITUS content that you created in the custom CMS area.
  • [history]
    This will display the History content that you created in the custom CMS area. (note, please also see documentation for custom field: history-image-attachment-id)
  • [display-event] – This tells the site to display an event. The specific event displayed is determined by the use of the custom field display-event-id (see custom fields above).
  • [faqs]
    This will display the FAQs content that you created in the custom CMS area.
  • [school-faqs-1]
    This will display the School Account top portion FAQs content that you created in the custom CMS area.
  • [school-faqs-2]
    This will display the School Account bottom portion FAQs content that you created in the custom CMS area.
  • [donate-main-form]
    For use on the main DONATE page. The form will appear in its place.
  • [donate-school-form]
    For use on the DONATE TO AN INDIVIDUAL SCHOOL page. The form will appear in its place.
  • [a4e-albums-???????????????]
    Displays one or more Flickr photo albums/sets. Where ??????????????? is a comma-delimited list of album or set IDs designated on Flickr.
  • [a4e-videos]
    For use on the VIDEOS page – displays the designated YouTube Video portfolio. (see custom fields for youtube-channel-url, youtube-default-tab and youtube-playlist-url to configure page).

Managing the DONATION Page
The donation page (where site visitors can donate a single amount, or a recurring amount), has several special handling custom fields:

  • form-thankyou-text
    This is the text that the donor will see when they successfully complete their donation.
  • donation-email-from-address
    This is the email address that will appear in the donor’s confirmation email.
  • donation-email-from-name
    This is the name that will be associated with the email address that appears in the donor’s confirmation email.
  • donation-email-subject
    This is the subject line that will appear in the donor’s confirmation email.
  • donation-email-notify
    This is the email address of the A4E person who should receive a separate email notification of the donation.
  • donation-email-text-single-amount
    This is the email BODY that will be sent to the donor when they donate a one-time/single amount. (see ‘customizing the donation confirmation email‘ below).
  • donation-email-text-recurring-amount
    This is the email BODY that will be sent to the donor when they donate a recurring amount. (see ‘customizing the donation confirmation email‘ below).
  • donation-email-text-pledge-amount
    This is the email BODY that will be sent to the donor when they donate a pledge amount (the 3rd radio button option on the “Donate to an Individual School” page). (see ‘customizing the donation confirmation email‘ below).
  • donation-email-text-single-amount-addon, donation-email-text-recurring-amount-addon, donation-email-text-pledge-amount-addon
    These 3 additional custom fields represent the email BODY that will be sent to the donor when they donate an “additional amount” in conjunction with one of the main donation types listed above.
  • donate-thankyou-page-title
    This is the page title that will appear to the donor once the donation has been made.

Customizing the donation confirmation email
You have the ability to set various ‘placeholder’ values in the confirmation email that goes out to the donor. These ‘placeholder’ values will be replaced with actual values at the time the email is actually delivered. Treat these ‘placeholder’ values just as you would a short code (see Short Codes above).
For example, your donation-email-text-single-amount could be something like:

Dear [firstname],
Thank you for your generous donation of [amount].
Sincerely,
John Doe
President.

The available ‘placeholder’ values are:

  • [firstname]
    Is replaced with the donor’s actual first name
  • [lastname]
    Is replaced with the donor’s actual last name
  • [amount]
    Is replaced with the donation amount. If a recurring donation, the amount used will be the monthly amount charged, not the cumulative total amount.
  • [transactiondate]
    Is replaced with the current date and time that the user made the donation on the website.
  • [recurringstartdate]
    Is the date that the recurring billing will actually begin (all recurring transactions are programmed to begin on the 15th of the month, or, if the donor created the gift after the 15th of the current month, the start date is programmed to be the 15th of the next month.
  • [schoolname]
    Is replaced by the name of the school/Group that the donor designated on the school donation page. Note that this only applies to the school donation page.
  • [totalpledgeamount]
    Of the 3 types of giving available to donors (one-time gift, recurring gift, pledge gift), this will be the TOTAL amount of the pledge gift designated by the donor. Note that this only applies to the school donation page, and only for pledge gift types.
  • [pledgemonths]
    Note that this only applies to the school donation page, and only for pledge gift types. This represents the number of months that the donor designated in their pledge gift.
  • [addonamount]
    Note that this only applies to the school donation page. It represents the additional gift amount (if made by the donor).

Managing the sidebar image for each section
You can set the sidebar image to be used for all pages within a section (that contain a sidebar) by performing the following steps:

  1. Navigate to the main section page for the desired section. For example, to set the sidebar image for all pages within the “Who We Are” section, navigate to the “Who We Are” page.
  2. Edit the PAGE in WordPress.
  3. Set the custom field called section-sidebar-image to the desired image name. Thereafter, all pages within that section, that contain a sidebar, will use that sidebar image.

The available choices for the sidebar image are:

  • sidebar-hand-connect.jpg
  • sidebar-hand-media.jpg
  • sidebar-hand-whoweare.jpg

Note: The default image to be used if no sidebar image is indicated for a section is: sidebar-hand-media.jpg