Plugin Extensions and Overrides - UCF/FinAid-Child-Theme GitHub Wiki

The FinAid Child Theme provides built-in compatibility for the plugins listed below. The extensions or overrides provided by this theme are also noted:

Advanced Custom Fields PRO

  • Custom fields are defined in this theme's dev directory. You do not need to upload the config file yourself; it is automatically loaded for you using ACF's local JSON feature, and future updates to the ACF config file will populate automatically when the theme is deployed.
  • To avoid confusion with ACF config syncing, the ACF settings pages are disabled on non-development environments when this theme is activated. If you're developing this theme and need to make a change to the ACF config, add the WP_LOCAL_DEV constant to your wp-config.php file in your local development environment and reload the WordPress admin. See the theme README for more information.
  • This theme adds a custom WYSIWYG field toolbar, named "Inline Text", with a simplified set of text editing tools.
  • The main post content WYSIWYG field for Sections is moved under the "Section Fields" field group using CSS + JS. (See acf_section_wysiwyg_position() in includes/config.php)

Athena Shortcodes

  • Responsive embeds are force-enabled.

TinyMCE Advanced

  • Includes a custom configuration for TinyMCE Advanced, which enables a user-friendly table editor in the WYSIWYG editor.

UCF FAQ Custom Post Type

  • Athena classes are force-enabled on FAQ-generated markup.
  • FAQ archives are force-disabled in favor of using curated pages.

UCF Section

  • Sections have been significantly altered in the FinAid Child Theme. Multiple new layouts for Sections have been added, which modify the available meta fields for the Section, and how the Section is displayed on the frontend:
    • List: displays a stylized <ol> or <ul> on the frontend with configurable icons and optional headings above each list item. List items are editable using a drag-and-drop interface in the admin.
    • Timeline: displays a stylized <dl> on the frontend with configurable headings and inner bullet items. Timelines are editable using a drag-and-drop interface in the admin.
    • Basic Section (default): displays a generic/vanilla Section.
  • Custom columns have been added to the WordPress admin view for Sections to help make it easier to distinguish between different Section layouts.
  • A custom page template has been added to the theme, "List", which will display a List Section with an auto-generated sidebar nav. This template requires that the selected List have headings defined on each list item.

Yoast SEO

  • Yoast's provided breadcrumb functionality is utilized in the child theme to generate breadcrumbs at the bottom of each page, immediately above the site footer (except the home page). Breadcrumb markup is overridden to utilize Athena Framework breadcrumb classes.
  • Some settings related to breadcrumbs are overridden in the child theme--specifically:
    • The breadcrumb separator is made blank
    • Forced bolding on the last breadcrumb item is enabled
    • The "Taxonomy to show in breadcrumbs for content types" for the FAQ post type is always set to "None".