The contents of the inc directory - jacki890/Largo GitHub Wiki

WordPress theme custom functions are defined in functions.php. To make maintenance and the creation of child themes easier, Largo splits its custom functions out into separate files in the /inc directory.

Miscellaneous functions:

  • ad-codes.php: If you have the Ad Codes Manager plugin installed, this provides:
    • some additional whitelisting
    • ad tag locations for Largo
  • cached-core-functions.php:
    • caches the wp_nav_menu for all tag and category pages used in the nav menus
    • tracks when the nav menus were last edited
  • custom-feeds.php:
    • creates a full-text RSS feed
    • creates a feed for easy MailChimp RSS import, using feed-mailchimp.php from the template directory (the root directory of the Largo theme).
  • custom-less-variables.php: If Custom LESS is enabled in Appearance > Theme Options > Advanced, then functions.php includes this file.
    • defines class Largo_Custom_Less_Variables
    • compiles custom LESS
    • provides UI for testing and publishing custom LESS
  • dashboard.php: customizes admin dashboard for members and nonmembers
  • editor.php: Adds the TinyMCE plugin to insert modules into posts.
  • enqueue.php: Hooks for JavaScript and CSS.
  • featured-content.php:
    • gets the featured posts
    • gets the main feature
    • ensures that there can be only one sticky post
    • determines if there are featured posts on archive pages
    • determines if there are featured posts on the homepage
  • header-footer.php: Contains the header, the footer copyright text, social links, favicon, SEO tags, and removes some spare elements from <head>.
  • home-template-functions.php: Functions to get the single post for the home-single template and to get the series posts for the hero-side-series template.
  • home-templates.php: Finds homepage templates, finds their thumbnails, loads them.
  • images.php: Removes <a> tags around attachments, returns the home icon, clears the home icon cache.
  • largo-plugin-init.php: Registers Largo's required plugins, has example code that can be used by child themes to register required plugins.
  • metabox-api.php: Defines the custom post metaboxes in the editor, provides a way to add a field to a metabox container.
  • nav-menus.php: Donation button, "Don't Miss" label, footer nav label, enhanced menu walker supporting second-level dropdown menus.
  • open-graph.php: Generates the Open Graph tags, and parses Twitter URLs for usernames.
  • post-meta.php:
    • moves the author dropdown to the publish metabox
    • removes some metaboxes from the edit screens
    • shows all (unhides) all the other metaboxes by default
    • adds some custom metaboxes to the post edit screens using the Largo Metabox API in /inc/metabox-api.php and provides their contents
  • post-tags.php: Functions related to the post page: publish time, author name, author link, post byline, post social links, author gravatar image, post pagination, post excerpts, next/previous post, post comments, post-type icon.
  • post-templates.php: Adds ability to select a custom post template for single posts.
  • related-content.php: Functions and the class Largo_Related that provide related posts for a post.
  • robots.php: Defaults for robots.txt.
  • sidebars.php: Registers sidebars, builds a dropdown menu of them.
  • taxonomies.php: Functions relating to custom taxonomies:
    • register the prominence and series custom taxonomies
    • determine if a post is in a series
    • output custom taxonomy terms attached to a posts
    • output format for series custom taxonomy at bottom of single posts
    • sort posts in proper landing-page order for a series
    • sort posts featured-first for category archive
  • term-icons.php: Displays the fields for selecting icons for terms in the "post-type" taxonomy.
  • term-meta.php: Adds custom meta fields functionality to terms, using a custom post type as a proxy to bridge between a term_id and a post_meta field.
  • term-sidebars.php: Displays the fields for selecting icons for terms in the "post-type" taxonomy.
  • update.php: Tools for updating from Largo 0.3 to 0.4.
  • users.php: User profiles for normal users and Co-Authors Plus guest authors, multisite user edit permissions for admins.
  • widgets.php: Sets up the Largo custom widgets, adds CSS classes to sidebar widgets, adds Largo-specific custom fields to widget forms, adds ability to have widget titles also be links.

Functions in directories:

Customizer: Adds Largo-specific functionality to the Customizer via the Theme Customization API and four custom classes. The customizer directory also contains relevant CSS and JavaScript.

Picturefill: Picturefill.WP is a plugin that uses picturefill.js to load responsive and retina images, mimicking the HTML5 <picture> spec.

Widgets: Largo's custom widgets. For more information about each widget, see Sidebars and widgets.

WP-Taxonomy-Landing: Provides a new post type, Landing Page. Requests to a taxonomy archive, such as a category or tag page, will check if a Landing Page has that taxonomy set. If one exists, and the request is for the landing page (that is, not an explicit request for page 1 or any following page), the Landing Page is displayed rather than the normal page 1 of the taxonomy archive.

Questions or comments? file an issue, or contact INN directly

⚠️ **GitHub.com Fallback** ⚠️