Template Integration

This guide covers how the docsync plugin integrates with the chubes theme.

What The Plugin Owns

docsync registers:

  • The documentation post type
  • The project taxonomy

It also injects archive/homepage enhancements by hooking into theme actions/filters.

Templates (Plugin Side)

The plugin doesn’t provide WordPress template files to override. Instead it hooks into the theme’s templates:

  • inc/Templates/Archive.php

  • inc/Templates/Homepage.php

    • Adds a “Documentation” column via the theme action chubes_homepage_columns
  • inc/Templates/RelatedPosts.php

    • Renders related docs for single documentation posts (theme integration)

Helper Functions

inc/Templates/Archive.php

  • Filters chubes_archive_content to render:
    • Project term archives (category grid vs term hierarchy)
    • Documentation archive grouping under /docs
  • Adds header UI via chubes_archive_header_after
  • Adjusts titles via get_the_archive_title
  • Renders project info cards in project term archives via render_header_extras()
    • Displays project statistics (doc count, install count, stars)
    • Shows action buttons (GitHub, WordPress.org, documentation)
    • Centers card statistics for improved layout

Assets

inc/Templates/Homepage.php

  • Project term archives (category grid vs term hierarchy)
  • Documentation archive grouping under /docs

inc/Templates/RelatedPosts.php

  • Displays project statistics (doc count, install count, stars)
  • Shows action buttons (GitHub, WordPress.org, documentation)
  • Centers card statistics for improved layout

Supported Hooks

inc/Templates/Archive.php

  • Adds a “Documentation” column via the theme action chubes_homepage_columns