ArchticFrame – Editable Archive Pages

الوصف

ArchticFrame provides a structured way to build content-managed archive pages for custom post types.

Normally, WordPress archive pages are controlled entirely by theme templates.
This makes it difficult for editors to manage archive content or layouts without modifying theme files.

ArchticFrame solves this by introducing Archive Pages.

An Archive Page is an internal content object that represents the archive content for a custom post type.
Editors can build archive layouts using:

• Gutenberg blocks
• Advanced Custom Fields (ACF)
• custom metadata
• reusable blocks

These Archive Pages are automatically linked to their corresponding custom post type archives.

The archive content can then be rendered within archive templates using simple helper functions.

Archive Pages behave like editable landing page content while still allowing the archive to display its normal post listings.

Key Concepts

ArchticFrame introduces a dedicated internal post type:

Archive Pages

Each Archive Page represents the content for a specific custom post type archive.

Examples:

• Projects → Archive Page
• Services → Archive Page
• Events → Archive Page

Archive Pages are automatically managed by the plugin and are intended to act as content sources for archive layouts.

Features

• Dedicated Archive Page for each enabled custom post type
• Gutenberg block support for archive layouts
• Compatible with Advanced Custom Fields (ACF)
• Automatic archive page creation and management
• Archive Pages stored in a dedicated admin section
• Automatic linking between Archive Pages and post type archives
• Template override support for themes
• Simple helper functions for theme developers

How It Works

1. Activate the plugin
2. Navigate to Archive Pages → Settings
3. Enable archive management for a custom post type
4. ArchticFrame automatically creates an Archive Page
5. Edit the Archive Page using Gutenberg or ACF
6. Render the archive content inside your archive template

The archive content can be placed above the post listing or anywhere within your archive layout.

Archive Pages Admin

ArchticFrame adds a new admin section:

Archive Pages

This section lists all Archive Pages managed by the plugin.

Each Archive Page corresponds to a specific custom post type archive.

Archive Pages include a View Archive link which opens the actual archive URL.

Editors manage the content of these pages, while archive relationships are handled automatically.

Template Loading

When archive management is enabled for a custom post type, ArchticFrame attempts to load templates in the following order:

1. archtic-{post_type}.php in the active theme
2. archtic.php in the active theme
3. the plugin fallback template

Examples:

archtic-projects.php
archtic-services.php
archtic.php

This allows theme developers to fully customise archive layouts while maintaining a safe fallback.

Content Sanitization

The plugin fallback template outputs archive content using standard WordPress sanitization.

This helps provide a safe default, but some custom markup may be altered or removed depending on how it is rendered. This can affect advanced custom HTML added through blocks, ACF output, or inline markup.

If you need full control over archive output, you can override the fallback template using archtic.php or archtic-{post_type}.php in your theme.

In cases where specific markup needs to be allowed, developers can also extend the permitted HTML using standard WordPress filters such as wp_kses_allowed_html.

Helper Functions

ArchticFrame provides helper functions for theme developers.

Output archive content:

Get the archive object ID:

$post_id = archticframe_id();

Get the archive title:

echo archticframe_title();

Retrieve an ACF field from the archive:

echo archticframe_field(‘subtitle’);

These helpers allow themes to integrate archive content without directly querying the archive object.

Archive Listings Shortcode

ArchticFrame includes a shortcode that allows archive listings to be displayed directly inside Archive Pages.

This allows editors to build custom archive layouts using Gutenberg blocks while still displaying the posts from the archive.

The shortcode automatically detects the current archive post type when used inside an ArchticFrame Archive Page.

Basic Usage

[archtic_listing]

This will output the archive posts for the current custom post type.

Shortcode Attributes

posts_per_page

Controls how many posts are displayed.

Default: 12

Example:

[archtic_listing posts_per_page=”6″]

show

Controls which elements appear for each listing item.

Available options:

• image
• title
• excerpt
• content
• button

Default:

image,title,excerpt,button

Example:

[archtic_listing show=”image,title,button”]

button_text

Changes the label used for the button when the button option is enabled.

Default:

Read more

Example:

[archtic_listing button_text=”View project”]

link

Controls how items link to their individual posts.

Available values:

• button – only the button links to the post
• card – the entire item card is clickable
• both – card and button both link to the post
• none – no links are generated

Default:

button

Example:

[archtic_listing link=”card”]

HTML Structure

The shortcode outputs the following structure to allow flexible styling:

Themes can style the archive listings using the following classes:

• .archtic-listings
• .archtic-wrap
• .archtic-grid
• .archtic-col
• .archtic-item
• .archtic-item__image
• .archtic-item__title
• .archtic-item__excerpt
• .archtic-item__content
• .archtic-item__actions
• .archtic-item__button

License

This plugin is licensed under the GPLv2 or later.

See: https://www.gnu.org/licenses/gpl-2.0.html