ArchiveWP Shortcodes

ArchiveWP registers three front-end shortcodes that mirror the plugin’s blocks. Each shortcode outputs escaped markup and can be combined inside classic templates, block theme patterns, custom PHP, or page builders such as Elementor or Divi.

• [archivewp_disclaimer] — prints the standard disclaimer wrapper.
• [archivewp_filters] — renders the archive search and filter form.
• [archivewp_loop] — outputs the archive results loop (with optional pagination).

For all shortcodes, boolean attributes accept true, false, 1, 0, or their string equivalents; any value that evaluates to false via FILTER_VALIDATE_BOOLEAN is treated as false.

[archivewp_disclaimer]

Functionality

This shortcode outputs the standard archive disclaimer markup.

The shortcode mirrors the block and does not accept arbitrary inner content—change the message through ArchiveWP settings or by filtering edawp_archived_content_message. See developer docs for filtering information.

Attributes

Attribute	Type	Default	Description
container_id	string	edawp-disclaimer-{unique}	id for the outer wrapper.
class	string	edawp-disclaimer	CSS classes applied to the outer wrapper.
additional_class	string	''	Optional space-separated classes appended to the wrapper.

To constrain the rendered width, add your own class and define the layout in CSS so both the block and shortcode stay in sync.

Legacy attributes such as text, show_title, and title are ignored but tolerated so that older content does not break.

Example

[archivewp_disclaimer additional_class="is-centered"]

Example Screenshot

Programmatic Rendering

\EqualizeDigital\ArchiveWP\Common\ArchiveDisclaimerRenderer::render( [
    'class'     => 'my-custom-disclaimer',
    'style'     => 'max-width:720px;margin-inline:auto;',
] );

Wrap the call in output buffering if you need the markup as a string.

[archivewp_filters]

Functionality

This shortcode outputs the same form used by the Archive Filters block.

Archive Filters form submissions post to the current URL and populate the following query parameters consumed by [archivewp_loop] and archive templates: 

• edawp_search 
• edawp_category (comma-separated)
• category[] (array fallback)
• post_type_filter[]/edawp_post_type
• edawp_archive_type
• and the nonce pair (edawp_filter_nonce)

Attributes

Attribute	Type	Default	Description
form_id	string	edawp-archive-form-shortcode-{unique}	id attribute applied to the <form> element.
show_heading	bool	false	When true, prints a heading before the form.
heading_text	string	Search Archive	Heading text when show_heading is enabled.
heading_tag	string	h2	HTML tag for the heading. Output is attribute-escaped.
show_search	bool	true	Toggle the keyword search input.
search_field_id	string	edawp-search-keyword-{unique}	id attribute for the search input.
show_filters	bool	true	Toggle the Archive Category checkbox list.
show_post_type_filter	bool	true	Toggle the original post type filter list.
search_label	string	Search by Keyword	Label text for the keyword field.
filter_legend	string	Filter by Category	<legend> text for the category filters.
post_type_legend	string	Filter by Content Type	<legend> text for the post type filters.
submit_text	string	Submit	Submit button label.
clear_text	string	Clear Filters	Label for the “clear filters” link.
reset_button_id	string	edawp-reset-filters-{unique}	id used by the JavaScript clear/reset behaviour.
visible_filters_limit	int	20	Show this many Archive Category checkboxes before collapsing the remainder behind a “Show More” toggle. Use 0 (or any value < 1) to show all filters.
collapse_on_mobile	bool	false	When true, wraps the form in an accessible toggle button that collapses filters on small screens.

The shortcode honors existing selections found in the query string and sets a nonce to support Ajax submissions. Hidden inputs ensure the request stays scoped to edawp_archived.

Example

[archivewp_filters show_heading="true" heading_text="Browse the Archive" visible_filters_limit="10"]

Example Screenshot

Programmatic rendering

To build the same markup from PHP, call:

\EqualizeDigital\ArchiveWP\Common\ArchiveFilterForm::render( [
    'show_heading' => true,
    'heading_text' => 'Search Archives',
] );

[archivewp_loop]

Functionality

This shortcode lists archived posts using the current request’s filters.

The shortcode respects edawp_search, edawp_category (comma-separated), category[], post_type_filter[]/edawp_post_type, edawp_archive_type, and paged query parameters. Combine it with [archivewp_filters] or pass attributes directly to control output.

Attributes

Attribute	Type	Default	Description
posts_per_page	int	10	Number of archived posts to fetch per page.
container_id	string	edawp-archive-results-shortcode-{unique}	id applied to the results <ul>.
pagination_show	bool	true	When true, outputs pagination markup plus data attributes consumed by the front-end script.
pagination_id	string	edawp-pagination-shortcode-{unique}	id for the pagination container.
pagination_prev_text	string	« Previous	Previous-link label.
pagination_next_text	string	Next »	Next-link label.
no_posts_message	string	No archived content found matching your criteria.	Message displayed when the query returns no results.
post_show_image	bool	true	Show the featured image when one exists.
post_image_size	string	thumbnail	Image size passed to get_the_post_thumbnail().
post_heading_tag	string	h3	Heading tag for entry titles (normalized to a safe heading element).
post_show_post_type	bool	false	Reserved attribute; the current renderer ignores it.
post_show_archive_date	bool	true	Legacy master toggle for the date row.
post_show_published_date	bool	inherits post_show_archive_date	Display the original published date.
post_show_archived_date	bool	inherits post_show_archive_date	Display the archive date (from _edawp_archived_date).
post_show_category	bool	true	Show Archive Category terms. Aliases: show_category, show_categories.
post_show_taxonomies	bool	true	Output original taxonomy terms captured during archiving.
post_show_excerpt	bool	true	Show the excerpt/content preview.
excerpt_word_length	int	55	Legacy alias for post_excerpt_word_count; respected when provided.
post_excerpt_word_count	int	55	Word count limit applied to generated excerpts.
post_show_read_more_link	bool	true	Show the “Read More” link.
post_read_more_text	string	Read More	Link text (HTML tags are stripped).
post_read_more_sr_text	string	about %s	Screen reader suffix appended to the link (receives the post title).
post_wrapper_tag	string	li	HTML tag used for each list item (normalized to a safe tag).
post_wrapper_class	string	edawp-archive-post	CSS class applied to each wrapper element.

All attributes are sanitized before output. Pagination uses WordPress’ native paging; ensure the shortcode sits on a page that supports pagination (e.g., an archive page or a page with the paged query var).

Example

[archivewp_loop posts_per_page="12" post_show_taxonomies="false" post_show_excerpt="false"]

Example Screenshot

Programmatic rendering

For full control in PHP, query archived posts yourself and hand the results to the renderer:

$query = new \WP_Query( [
    'post_type'      => 'edawp_archived',
    'posts_per_page' => 6,
] );

\EqualizeDigital\ArchiveWP\Common\ArchivePostRenderer::render_list( $query, [
    'post_show_taxonomies' => false,
] );