';\n\n return $content . $box;\n}, 20 );",
"requires": [],
"notes": ""
},
{
"id": "ad-after-paragraph",
"version": 1,
"title": "Ad Slot After a Paragraph",
"description": "Inserts a block of HTML (an ad, a newsletter prompt or any call to action) after the third paragraph of single posts.",
"category": "content",
"tags": [
"content",
"ads",
"monetization",
"html"
],
"code_type": "html",
"insert_method": "auto",
"location": "after_paragraph",
"insert_number": 3,
"code": "
\n \n
Your ad or call to action goes here.
\n
",
"requires": [],
"notes": "Change the paragraph number in the snippet settings."
},
{
"id": "newsletter-box-after-content",
"version": 1,
"title": "Newsletter Call to Action After Content",
"description": "Adds a simple sign-up box at the end of post content that links to your newsletter page or form.",
"category": "content",
"tags": [
"content",
"newsletter",
"cta",
"html"
],
"code_type": "html",
"insert_method": "auto",
"location": "after_content",
"insert_number": 1,
"code": "
\n
Enjoyed this article?
\n
Get new posts delivered to your inbox. No spam, unsubscribe at any time.
",
"requires": [],
"notes": ""
},
{
"id": "dismissible-announcement-bar",
"version": 1,
"title": "Dismissible Announcement Bar",
"description": "Shows a slim message bar at the top of the page (for sales, shipping notes or news) that visitors can close. It stays closed on later visits.",
"category": "frontend",
"tags": [
"html",
"javascript",
"announcement",
"notice"
],
"code_type": "html",
"insert_method": "auto",
"location": "site_wide_body",
"insert_number": 1,
"code": "
\n Free shipping on all orders this week. Shop now\n \n
\n",
"requires": [],
"notes": "Edit the message and link. Change the key (wpide-announcement-1) whenever you publish a new announcement so it shows again to everyone."
},
{
"id": "print-friendly-styles",
"version": 1,
"title": "Print-Friendly Styles",
"description": "Hides navigation, sidebars, comments and the admin bar when a page is printed, and prints link addresses after external links.",
"category": "frontend",
"tags": [
"css",
"print",
"accessibility"
],
"code_type": "css",
"insert_method": "auto",
"location": "site_wide_header",
"insert_number": 1,
"code": "@media print {\n #wpadminbar,\n .site-header nav,\n .main-navigation,\n .widget-area,\n .sidebar,\n .comments-area,\n .site-footer nav,\n .wp-block-navigation {\n display: none !important;\n }\n\n body {\n color: #000;\n background: #fff;\n }\n\n .entry-content a[href^=\"http\"]::after {\n content: \" (\" attr(href) \")\";\n font-size: 90%;\n }\n}",
"requires": [],
"notes": "Adjust the selectors to match the class names used by your theme."
},
{
"id": "slug-column-admin-lists",
"version": 1,
"title": "Slug Column in Admin Lists",
"description": "Adds a Slug column to the posts and pages lists so you can check permalinks without opening each item.",
"category": "admin",
"tags": [
"admin",
"columns",
"permalinks"
],
"code_type": "php",
"insert_method": "auto",
"location": "admin_only",
"insert_number": 1,
"code": "// Post types that get the Slug column.\n$wpide_slug_post_types = array( 'post', 'page' );\n\nforeach ( $wpide_slug_post_types as $wpide_slug_type ) {\n add_filter( \"manage_{$wpide_slug_type}_posts_columns\", function ( $columns ) {\n $columns['wpide_slug'] = 'Slug';\n\n return $columns;\n } );\n\n add_action( \"manage_{$wpide_slug_type}_posts_custom_column\", function ( $column, $post_id ) {\n if ( 'wpide_slug' === $column ) {\n echo '' . esc_html( urldecode( (string) get_post_field( 'post_name', $post_id ) ) ) . '';\n }\n }, 10, 2 );\n}",
"requires": [],
"notes": "Add custom post type names to $wpide_slug_post_types to show the column there too."
},
{
"id": "page-template-column",
"version": 1,
"title": "Page Template Column for Pages",
"description": "Shows which page template each page uses, right in the Pages list.",
"category": "admin",
"tags": [
"admin",
"columns",
"templates"
],
"code_type": "php",
"insert_method": "auto",
"location": "admin_only",
"insert_number": 1,
"code": "add_filter( 'manage_page_posts_columns', function ( $columns ) {\n $columns['wpide_template'] = 'Template';\n\n return $columns;\n} );\n\nadd_action( 'manage_page_posts_custom_column', function ( $column, $post_id ) {\n if ( 'wpide_template' !== $column ) {\n return;\n }\n\n $slug = get_page_template_slug( $post_id );\n\n if ( ! $slug ) {\n echo '— Default';\n return;\n }\n\n $templates = wp_get_theme()->get_page_templates( null, 'page' );\n\n echo esc_html( isset( $templates[ $slug ] ) ? $templates[ $slug ] : $slug );\n}, 10, 2 );",
"requires": [],
"notes": ""
},
{
"id": "filter-posts-by-author",
"version": 1,
"title": "Filter Posts by Author in the Admin List",
"description": "Adds an author dropdown next to the date and category filters, so editors can list one writer's posts.",
"category": "admin",
"tags": [
"admin",
"filters",
"authors"
],
"code_type": "php",
"insert_method": "auto",
"location": "admin_only",
"insert_number": 1,
"code": "add_action( 'restrict_manage_posts', function ( $post_type ) {\n if ( ! post_type_supports( $post_type, 'author' ) || ! current_user_can( 'edit_others_posts' ) ) {\n return;\n }\n\n wp_dropdown_users( array(\n 'name' => 'author',\n 'show_option_all' => 'All authors',\n 'selected' => isset( $_GET['author'] ) ? absint( $_GET['author'] ) : 0,\n 'capability' => array( 'edit_posts' ),\n 'hide_if_only_one_author' => true,\n ) );\n} );",
"requires": [],
"notes": "WordPress already understands the author filter; this snippet only adds the dropdown."
},
{
"id": "filter-admin-lists-by-taxonomy",
"version": 1,
"title": "Filter Admin Lists by Any Taxonomy",
"description": "Adds a dropdown filter for every taxonomy attached to a post type, such as tags or custom taxonomies on a portfolio.",
"category": "admin",
"tags": [
"admin",
"filters",
"taxonomies"
],
"code_type": "php",
"insert_method": "auto",
"location": "admin_only",
"insert_number": 1,
"code": "// Taxonomies that should not get a dropdown (WordPress already shows one for post categories).\n$wpide_tax_filter_skip = array( 'category', 'post_format' );\n\nadd_action( 'restrict_manage_posts', function ( $post_type ) use ( $wpide_tax_filter_skip ) {\n foreach ( get_object_taxonomies( $post_type, 'objects' ) as $taxonomy ) {\n if ( ! $taxonomy->show_ui || ! $taxonomy->query_var || in_array( $taxonomy->name, $wpide_tax_filter_skip, true ) ) {\n continue;\n }\n\n $selected = isset( $_GET[ $taxonomy->query_var ] ) ? sanitize_title( wp_unslash( $_GET[ $taxonomy->query_var ] ) ) : '';\n\n wp_dropdown_categories( array(\n 'taxonomy' => $taxonomy->name,\n 'name' => $taxonomy->query_var,\n 'value_field' => 'slug',\n 'selected' => $selected,\n 'show_option_all' => $taxonomy->labels->all_items,\n 'hierarchical' => $taxonomy->hierarchical,\n 'hide_empty' => false,\n 'hide_if_empty' => true,\n 'show_count' => true,\n ) );\n }\n} );\n\n// The \"All\" option submits 0; drop it so the list is not filtered by a term called \"0\".\nadd_filter( 'request', function ( $vars ) {\n if ( ! is_admin() ) {\n return $vars;\n }\n\n foreach ( get_taxonomies( array( 'show_ui' => true ), 'objects' ) as $taxonomy ) {\n if ( $taxonomy->query_var && isset( $vars[ $taxonomy->query_var ] ) && '0' === (string) $vars[ $taxonomy->query_var ] ) {\n unset( $vars[ $taxonomy->query_var ] );\n }\n }\n\n return $vars;\n} );",
"requires": [],
"notes": ""
},
{
"id": "menu-order-column",
"version": 1,
"title": "Sortable Order Column for Pages",
"description": "Shows the page order (menu_order) value in the Pages list and lets you sort by it.",
"category": "admin",
"tags": [
"admin",
"columns",
"pages"
],
"code_type": "php",
"insert_method": "auto",
"location": "admin_only",
"insert_number": 1,
"code": "add_filter( 'manage_page_posts_columns', function ( $columns ) {\n $columns['wpide_menu_order'] = 'Order';\n\n return $columns;\n} );\n\nadd_action( 'manage_page_posts_custom_column', function ( $column, $post_id ) {\n if ( 'wpide_menu_order' === $column ) {\n echo (int) get_post_field( 'menu_order', $post_id );\n }\n}, 10, 2 );\n\nadd_filter( 'manage_edit-page_sortable_columns', function ( $columns ) {\n $columns['wpide_menu_order'] = 'menu_order';\n\n return $columns;\n} );",
"requires": [],
"notes": ""
},
{
"id": "admin-search-by-post-id",
"version": 1,
"title": "Find Posts by ID in the Admin Search",
"description": "Type #123 or id:123 in the posts or pages search box to jump straight to the item with that ID.",
"category": "admin",
"tags": [
"admin",
"search",
"post-id"
],
"code_type": "php",
"insert_method": "auto",
"location": "admin_only",
"insert_number": 1,
"code": "add_action( 'pre_get_posts', function ( $query ) {\n global $pagenow;\n\n if ( ! is_admin() || ! $query->is_main_query() || 'edit.php' !== $pagenow ) {\n return;\n }\n\n $search = trim( (string) $query->get( 's' ) );\n\n if ( preg_match( '/^(?:#|id:\\s*)(\\d+)$/i', $search, $match ) ) {\n $query->set( 's', '' );\n $query->set( 'p', (int) $match[1] );\n }\n} );",
"requires": [],
"notes": "Plain numbers are still searched as text, so titles like \"2025\" keep working."
},
{
"id": "admin-list-items-per-page",
"version": 1,
"title": "Default Number of Items in Admin Lists",
"description": "Shows more (or fewer) posts per page in admin lists for everyone who has not chosen their own number in Screen Options.",
"category": "admin",
"tags": [
"admin",
"list-table",
"pagination"
],
"code_type": "php",
"insert_method": "auto",
"location": "admin_only",
"insert_number": 1,
"code": "// Items per page when a user has not set their own value in Screen Options.\n$wpide_admin_per_page = 50;\n\nadd_filter( 'edit_posts_per_page', function ( $per_page, $post_type ) use ( $wpide_admin_per_page ) {\n $own = get_user_option( \"edit_{$post_type}_per_page\" );\n\n return empty( $own ) ? $wpide_admin_per_page : $per_page;\n}, 10, 2 );",
"requires": [],
"notes": "Very high values make list screens slower on large sites."
},
{
"id": "admin-sort-by-modified-default",
"version": 1,
"title": "Sort Admin Lists by Last Modified by Default",
"description": "Lists recently edited posts first in the admin, unless you click a column to sort differently.",
"category": "admin",
"tags": [
"admin",
"list-table",
"sorting"
],
"code_type": "php",
"insert_method": "auto",
"location": "admin_only",
"insert_number": 1,
"code": "// Post types whose admin list should default to \"last modified first\".\n$wpide_sort_modified_types = array( 'post' );\n\nadd_action( 'pre_get_posts', function ( $query ) use ( $wpide_sort_modified_types ) {\n global $pagenow;\n\n if ( ! is_admin() || ! $query->is_main_query() || 'edit.php' !== $pagenow || isset( $_GET['orderby'] ) ) {\n return;\n }\n\n $post_type = $query->get( 'post_type' ) ? $query->get( 'post_type' ) : 'post';\n\n if ( in_array( $post_type, $wpide_sort_modified_types, true ) ) {\n $query->set( 'orderby', 'modified' );\n $query->set( 'order', 'DESC' );\n }\n} );",
"requires": [],
"notes": ""
},
{
"id": "site-wide-admin-notice",
"version": 1,
"title": "Site-Wide Admin Notice",
"description": "Shows your own message at the top of every admin screen, for example \"This is the staging site\" or a reminder for editors.",
"category": "admin",
"tags": [
"admin",
"notices",
"message"
],
"code_type": "php",
"insert_method": "auto",
"location": "admin_only",
"insert_number": 1,
"code": "$wpide_admin_notice = array(\n 'message' => 'Heads up: content freeze until Friday. Please save changes as drafts.',\n 'type' => 'warning', // info, success, warning or error.\n 'capability' => 'edit_posts', // Who sees it.\n);\n\nadd_action( 'admin_notices', function () use ( $wpide_admin_notice ) {\n if ( ! current_user_can( $wpide_admin_notice['capability'] ) ) {\n return;\n }\n\n printf(\n '
\n",
"requires": [],
"notes": "Links to the comment form (#respond), which exists in classic and block themes."
},
{
"id": "comment-invitation-near-end",
"version": 1,
"title": "Comment Invitation Near the End of Posts",
"description": "Asks readers a question near the end of each post (after 80% of the content) and links straight to the comment form.",
"category": "comments",
"tags": [
"comments",
"engagement",
"call-to-action"
],
"code_type": "universal",
"insert_method": "auto",
"location": "content_80",
"insert_number": 1,
"code": "\n\n",
"requires": [],
"notes": ""
},
{
"id": "woo-review-prompt-after-summary",
"version": 1,
"title": "Review Prompt Below the Product Summary",
"description": "Adds a \"Bought this? Share your review\" link with the current review count under the WooCommerce product summary, opening the Reviews tab.",
"category": "comments",
"tags": [
"comments",
"woocommerce",
"reviews"
],
"code_type": "universal",
"insert_method": "auto",
"location": "wc_after_single_product_summary",
"insert_number": 1,
"code": "get_reviews_allowed() && 'yes' === get_option( 'woocommerce_enable_reviews' ) ) :\n $wpide_reviews = (int) $product->get_review_count();\n ?>\n
', esc_url( wp_login_url( get_permalink() ) ) );\n}, 20 );",
"requires": [],
"notes": "Logged-in users of any role see and post comments as usual."
},
{
"id": "report-comment-link",
"version": 1,
"title": "Let Visitors Report Inappropriate Comments",
"description": "Adds a \"Report\" link to each comment; moderators get an email on the first report and the comment is held for review after three reports.",
"category": "comments",
"tags": [
"comments",
"moderation",
"community"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Reports after which a comment is unpublished until a moderator reviews it.\n$wpide_report_threshold = 3;\n\nadd_filter( 'comment_text', function ( $text, $comment ) {\n if ( is_admin() || wp_is_json_request() || ! ( $comment instanceof WP_Comment ) || '1' !== (string) $comment->comment_approved || is_feed() ) {\n return $text;\n }\n\n return $text . sprintf( '
\n",
"requires": [],
"notes": "Nothing is shown on posts without approved comments."
},
{
"id": "edd-download-questions-prompt",
"version": 1,
"title": "Questions Prompt Below Easy Digital Downloads Products",
"description": "Invites visitors to ask questions in the comments at the end of each Easy Digital Downloads product page, when comments are open.",
"category": "comments",
"tags": [
"comments",
"edd",
"engagement"
],
"code_type": "universal",
"insert_method": "auto",
"location": "edd_after_download_content",
"insert_number": 1,
"code": "\n
\n Questions before you buy? Ask them in the comments and we will answer publicly so others can benefit too.\n
\n",
"requires": [
"edd"
],
"notes": "Downloads need comments enabled for the prompt to appear."
},
{
"id": "automatic-table-of-contents",
"version": 1,
"title": "Automatic Table of Contents",
"description": "Adds a linked table of contents above posts that have enough headings, and gives each heading an anchor so readers can jump straight to a section.",
"category": "content",
"tags": [
"toc",
"headings",
"navigation"
],
"code_type": "php",
"insert_method": "auto",
"location": "frontend_only",
"insert_number": 1,
"code": "// Minimum number of headings before the table of contents appears.\n$wpide_toc_min_headings = 3;\n// Heading levels to include (2 = h2, 3 = h3 ...).\n$wpide_toc_levels = array( 2, 3 );\n// Title shown above the list.\n$wpide_toc_title = 'Contents';\n\nadd_filter( 'the_content', function ( $content ) use ( $wpide_toc_min_headings, $wpide_toc_levels, $wpide_toc_title ) {\n if ( ! is_singular( 'post' ) || ! in_the_loop() || ! is_main_query() ) {\n return $content;\n }\n\n $levels = implode( '', array_map( 'absint', $wpide_toc_levels ) );\n $pattern = '/]*)>(.*?)<\\/h\\1>/is';\n\n if ( ! preg_match_all( $pattern, $content, $found ) || count( $found[0] ) < $wpide_toc_min_headings ) {\n return $content;\n }\n\n $used = array();\n $items = array();\n\n $result = preg_replace_callback( $pattern, function ( $m ) use ( &$used, &$items ) {\n $text = trim( wp_strip_all_tags( $m[3] ) );\n $attrs = $m[2];\n\n if ( preg_match( '/\\sid=[\"\\']([^\"\\']+)[\"\\']/i', $attrs, $id_match ) ) {\n $id = $id_match[1];\n } else {\n $base = sanitize_title( $text );\n $base = '' !== $base ? $base : 'section';\n $id = $base;\n $i = 2;\n\n while ( isset( $used[ $id ] ) ) {\n $id = $base . '-' . $i++;\n }\n\n $attrs .= ' id=\"' . esc_attr( $id ) . '\"';\n }\n\n $used[ $id ] = true;\n $items[] = array( 'level' => (int) $m[1], 'id' => $id, 'text' => $text );\n\n return '' . $m[3] . '';\n }, $content );\n\n if ( null === $result || ! $items ) {\n return $content;\n }\n\n $top = min( wp_list_pluck( $items, 'level' ) );\n $html = '' . $result;\n}, 20 );",
"requires": [],
"notes": "Change the minimum heading count, the heading levels or the title in the variables at the top."
},
{
"id": "heading-anchor-links",
"version": 1,
"title": "Copyable Anchor Links on Headings",
"description": "Gives h2 to h4 headings in posts and pages an ID and a small # link that appears on hover, so readers can share a link to an exact section.",
"category": "content",
"tags": [
"headings",
"anchors",
"links"
],
"code_type": "php",
"insert_method": "auto",
"location": "frontend_only",
"insert_number": 1,
"code": "add_filter( 'the_content', function ( $content ) {\n if ( ! is_singular() || ! in_the_loop() || ! is_main_query() ) {\n return $content;\n }\n\n $used = array();\n\n $result = preg_replace_callback( '/]*)>(.*?)<\\/h\\1>/is', function ( $m ) use ( &$used ) {\n $attrs = $m[2];\n\n if ( preg_match( '/\\sid=[\"\\']([^\"\\']+)[\"\\']/i', $attrs, $id_match ) ) {\n $id = $id_match[1];\n } else {\n $base = sanitize_title( wp_strip_all_tags( $m[3] ) );\n $base = '' !== $base ? $base : 'section';\n $id = $base;\n $i = 2;\n\n while ( isset( $used[ $id ] ) ) {\n $id = $base . '-' . $i++;\n }\n\n $attrs .= ' id=\"' . esc_attr( $id ) . '\"';\n }\n\n $used[ $id ] = true;\n\n return '' . $m[3] . ' #';\n }, $content );\n\n return null === $result ? $content : $result;\n}, 25 );\n\nadd_action( 'wp_head', function () {\n echo '' . \"\\n\";\n} );",
"requires": [],
"notes": "Works alongside the table of contents snippet; headings that already have an ID keep it."
},
{
"id": "reading-time-above-posts",
"version": 1,
"title": "Estimated Reading Time Above Posts",
"description": "Shows a short \"5 min read\" line at the top of every blog post, calculated from the number of words in the post.",
"category": "content",
"tags": [
"reading-time",
"posts",
"engagement"
],
"code_type": "php",
"insert_method": "auto",
"location": "frontend_only",
"insert_number": 1,
"code": "// Average reading speed in words per minute.\n$wpide_words_per_minute = 220;\n// Text after the number of minutes.\n$wpide_reading_label = 'min read';\n\nadd_filter( 'the_content', function ( $content ) use ( $wpide_words_per_minute, $wpide_reading_label ) {\n if ( ! is_singular( 'post' ) || ! in_the_loop() || ! is_main_query() ) {\n return $content;\n }\n\n $text = wp_strip_all_tags( strip_shortcodes( get_post_field( 'post_content', get_the_ID() ) ) );\n $words = count( preg_split( '/\\s+/u', trim( $text ), -1, PREG_SPLIT_NO_EMPTY ) );\n $minutes = max( 1, (int) ceil( $words / max( 1, $wpide_words_per_minute ) ) );\n\n return '
' . $content;\n}, 20 );",
"requires": [],
"notes": "Adjust the reading speed in words per minute or the label text at the top of the snippet."
},
{
"id": "word-count-shortcode",
"version": 1,
"title": "Word Count Shortcode",
"description": "Adds a [word_count] shortcode that prints how many words the current post contains, handy for long-form guides and writing portfolios.",
"category": "content",
"tags": [
"shortcode",
"word-count",
"posts"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_shortcode( 'word_count', function ( $atts ) {\n $atts = shortcode_atts( array( 'id' => 0 ), $atts, 'word_count' );\n $post_id = $atts['id'] ? absint( $atts['id'] ) : get_the_ID();\n\n if ( ! $post_id || ( ! is_post_publicly_viewable( $post_id ) && ! current_user_can( 'read_post', $post_id ) ) ) {\n return '';\n }\n\n $text = wp_strip_all_tags( strip_shortcodes( get_post_field( 'post_content', $post_id ) ) );\n $count = count( preg_split( '/\\s+/u', trim( $text ), -1, PREG_SPLIT_NO_EMPTY ) );\n\n return '' . esc_html( number_format_i18n( $count ) ) . '';\n} );",
"requires": [],
"notes": "Use [word_count id=\"123\"] to show the count of another post."
},
{
"id": "simple-post-views-counter",
"version": 1,
"title": "Simple Post Views Counter",
"description": "Counts how many times each blog post is viewed, shows the total in a Views column in the posts list and adds a [post_views] shortcode for the front end.",
"category": "content",
"tags": [
"views",
"statistics",
"posts"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'template_redirect', function () {\n if ( ! is_singular( 'post' ) || is_preview() || current_user_can( 'edit_posts' ) ) {\n return;\n }\n\n $agent = isset( $_SERVER['HTTP_USER_AGENT'] ) ? strtolower( sanitize_text_field( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ) ) : '';\n\n if ( '' === $agent || preg_match( '/bot|crawl|spider|slurp|preview|monitor|facebookexternalhit/', $agent ) ) {\n return;\n }\n\n $post_id = get_queried_object_id();\n update_post_meta( $post_id, 'wpide_post_views', (int) get_post_meta( $post_id, 'wpide_post_views', true ) + 1 );\n} );\n\nadd_shortcode( 'post_views', function ( $atts ) {\n $atts = shortcode_atts( array( 'id' => 0 ), $atts, 'post_views' );\n $post_id = $atts['id'] ? absint( $atts['id'] ) : get_the_ID();\n\n return '' . esc_html( number_format_i18n( (int) get_post_meta( $post_id, 'wpide_post_views', true ) ) ) . '';\n} );\n\nadd_filter( 'manage_post_posts_columns', function ( $columns ) {\n $columns['wpide_views'] = 'Views';\n\n return $columns;\n} );\n\nadd_action( 'manage_post_posts_custom_column', function ( $column, $post_id ) {\n if ( 'wpide_views' === $column ) {\n echo esc_html( number_format_i18n( (int) get_post_meta( $post_id, 'wpide_post_views', true ) ) );\n }\n}, 10, 2 );",
"requires": [],
"notes": "Visits from logged-in editors and common bots are not counted. Full-page caching stops the counter from seeing cached visits."
},
{
"id": "share-links-after-posts",
"version": 1,
"title": "Share Links Below Posts",
"description": "Adds plain share links for X, Facebook, LinkedIn, WhatsApp and email under each blog post. No third-party scripts or tracking pixels are loaded.",
"category": "content",
"tags": [
"social",
"sharing",
"posts"
],
"code_type": "php",
"insert_method": "auto",
"location": "frontend_only",
"insert_number": 1,
"code": "// Networks to show, in order. Available: x, facebook, linkedin, whatsapp, email.\n$wpide_share_networks = array( 'x', 'facebook', 'linkedin', 'whatsapp', 'email' );\n// Heading above the links.\n$wpide_share_label = 'Share this post';\n\nadd_filter( 'the_content', function ( $content ) use ( $wpide_share_networks, $wpide_share_label ) {\n if ( ! is_singular( 'post' ) || ! in_the_loop() || ! is_main_query() ) {\n return $content;\n }\n\n $url = rawurlencode( get_permalink() );\n $title = rawurlencode( wp_strip_all_tags( get_the_title() ) );\n $all = array(\n 'x' => array( 'X', 'https://x.com/intent/post?url=' . $url . '&text=' . $title ),\n 'facebook' => array( 'Facebook', 'https://www.facebook.com/sharer/sharer.php?u=' . $url ),\n 'linkedin' => array( 'LinkedIn', 'https://www.linkedin.com/sharing/share-offsite/?url=' . $url ),\n 'whatsapp' => array( 'WhatsApp', 'https://wa.me/?text=' . $title . '%20' . $url ),\n 'email' => array( 'Email', 'mailto:?subject=' . $title . '&body=' . $url ),\n );\n\n $links = '';\n\n foreach ( $wpide_share_networks as $network ) {\n if ( ! isset( $all[ $network ] ) ) {\n continue;\n }\n\n $external = 'email' !== $network ? ' target=\"_blank\" rel=\"noopener noreferrer\"' : '';\n $links .= '' . esc_html( $all[ $network ][0] ) . '';\n }\n\n return $content . '
' . esc_html( $wpide_share_label ) . '
' . $links . '
';\n}, 30 );",
"requires": [],
"notes": "Remove networks you do not want from the $wpide_share_networks list."
},
{
"id": "print-button-shortcode",
"version": 1,
"title": "Print Button Shortcode",
"description": "Adds a [print_button] shortcode that places a button visitors can click to print the current page, useful for recipes, guides and forms.",
"category": "content",
"tags": [
"shortcode",
"print",
"button"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_shortcode( 'print_button', function ( $atts ) {\n $atts = shortcode_atts( array( 'label' => 'Print this page' ), $atts, 'print_button' );\n\n return '';\n} );",
"requires": [],
"notes": "Change the label with [print_button label=\"Print this recipe\"]."
},
{
"id": "affiliate-disclosure-by-category",
"version": 1,
"title": "Affiliate Disclosure on Selected Categories",
"description": "Shows an affiliate or sponsorship disclosure at the top of posts in the categories you choose, so you never forget to add it by hand.",
"category": "content",
"tags": [
"affiliate",
"disclosure",
"compliance"
],
"code_type": "php",
"insert_method": "auto",
"location": "frontend_only",
"insert_number": 1,
"code": "// Category slugs that need the disclosure.\n$wpide_disclosure_categories = array( 'reviews', 'deals' );\n// Disclosure text (basic HTML allowed).\n$wpide_disclosure_text = 'This post contains affiliate links. If you buy through them we may earn a commission, at no extra cost to you.';\n\nadd_filter( 'the_content', function ( $content ) use ( $wpide_disclosure_categories, $wpide_disclosure_text ) {\n if ( ! is_singular( 'post' ) || ! in_the_loop() || ! is_main_query() || ! has_category( $wpide_disclosure_categories ) ) {\n return $content;\n }\n\n return '
' . wp_kses_post( $wpide_disclosure_text ) . '
' . $content;\n}, 20 );",
"requires": [],
"notes": "Set the category slugs and the disclosure text at the top of the snippet."
},
{
"id": "old-post-notice",
"version": 1,
"title": "Notice on Old Posts",
"description": "Warns readers at the top of posts older than a set number of years that the information may be out of date.",
"category": "content",
"tags": [
"posts",
"notice",
"outdated"
],
"code_type": "php",
"insert_method": "auto",
"location": "frontend_only",
"insert_number": 1,
"code": "// Posts older than this many years get the notice.\n$wpide_old_post_years = 2;\n// Message shown; %s becomes the age of the post.\n$wpide_old_post_message = 'This article was published %s ago, so some details may be out of date.';\n\nadd_filter( 'the_content', function ( $content ) use ( $wpide_old_post_years, $wpide_old_post_message ) {\n if ( ! is_singular( 'post' ) || ! in_the_loop() || ! is_main_query() ) {\n return $content;\n }\n\n $published = (int) get_post_time( 'U', true );\n\n if ( ! $published || $published > strtotime( '-' . absint( $wpide_old_post_years ) . ' years' ) ) {\n return $content;\n }\n\n $notice = sprintf( $wpide_old_post_message, human_time_diff( $published, time() ) );\n\n return '
' . esc_html( $notice ) . '
' . $content;\n}, 20 );",
"requires": [],
"notes": "Change the age in years and the message; %s is replaced with the age, such as \"3 years\"."
},
{
"id": "scheduled-content-shortcode",
"version": 1,
"title": "Show Content Between Two Dates",
"description": "Adds a [scheduled] shortcode that shows the text inside it only from a start date, until an end date, or between both. Ideal for limited offers and event notices.",
"category": "content",
"tags": [
"shortcode",
"schedule",
"dates"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_shortcode( 'scheduled', function ( $atts, $content = '' ) {\n $atts = shortcode_atts( array( 'from' => '', 'until' => '' ), $atts, 'scheduled' );\n $now = time();\n\n if ( '' !== $atts['from'] ) {\n $from = date_create( $atts['from'], wp_timezone() );\n\n if ( $from && $now < $from->getTimestamp() ) {\n return '';\n }\n }\n\n if ( '' !== $atts['until'] ) {\n $until = date_create( $atts['until'], wp_timezone() );\n\n if ( $until && $now > $until->getTimestamp() ) {\n return '';\n }\n }\n\n return do_shortcode( (string) $content );\n} );",
"requires": [],
"notes": "Example: [scheduled from=\"2026-11-25 00:00\" until=\"2026-11-30 23:59\"]Black Friday sale![/scheduled]. Dates use the site time zone. Page caching may delay the switch."
},
{
"id": "logged-in-logged-out-content-shortcodes",
"version": 1,
"title": "Content for Logged-In or Logged-Out Visitors",
"description": "Adds [members_only] and [guests_only] shortcodes so you can show different text, links or offers to visitors depending on whether they are logged in.",
"category": "content",
"tags": [
"shortcode",
"members",
"visibility"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_shortcode( 'members_only', function ( $atts, $content = '' ) {\n $atts = shortcode_atts( array( 'message' => '' ), $atts, 'members_only' );\n\n if ( is_user_logged_in() ) {\n return do_shortcode( (string) $content );\n }\n\n return '' !== $atts['message'] ? '
';\n} );",
"requires": [],
"notes": "Example: [recent_posts number=\"5\" category=\"news\" show_date=\"yes\"]."
},
{
"id": "previous-next-post-links",
"version": 1,
"title": "Previous and Next Post Links Below Posts",
"description": "Adds links to the previous and next post at the end of each blog post, for themes that do not show post navigation.",
"category": "content",
"tags": [
"navigation",
"posts",
"internal-links"
],
"code_type": "php",
"insert_method": "auto",
"location": "frontend_only",
"insert_number": 1,
"code": "// Only link to posts that share a category with the current post.\n$wpide_same_category = false;\n\nadd_filter( 'the_content', function ( $content ) use ( $wpide_same_category ) {\n if ( ! is_singular( 'post' ) || ! in_the_loop() || ! is_main_query() ) {\n return $content;\n }\n\n $previous = get_previous_post_link( '
', '%title', $wpide_same_category );\n\n if ( ! $previous && ! $next ) {\n return $content;\n }\n\n return $content . '';\n}, 40 );",
"requires": [],
"notes": "Set $wpide_same_category to true to only link to posts in the same category."
},
{
"id": "featured-image-above-content",
"version": 1,
"title": "Show the Featured Image Above Post Content",
"description": "Prints the featured image at the top of single posts, for themes that only use featured images on archive pages.",
"category": "content",
"tags": [
"featured-image",
"posts",
"images"
],
"code_type": "php",
"insert_method": "auto",
"location": "frontend_only",
"insert_number": 1,
"code": "// Image size to display.\n$wpide_featured_size = 'large';\n\nadd_filter( 'the_content', function ( $content ) use ( $wpide_featured_size ) {\n if ( ! is_singular( 'post' ) || ! in_the_loop() || ! is_main_query() || ! has_post_thumbnail() ) {\n return $content;\n }\n\n $image = get_the_post_thumbnail( null, $wpide_featured_size, array( 'loading' => 'eager', 'fetchpriority' => 'high' ) );\n $caption = get_the_post_thumbnail_caption();\n $caption = $caption ? '' . wp_kses_post( $caption ) . '' : '';\n\n return '' . $image . $caption . '' . $content;\n}, 5 );",
"requires": [],
"notes": "Change the image size from large to full or any registered size. Do not use it if your theme already shows the image on single posts."
},
{
"id": "find-and-replace-text",
"version": 1,
"title": "Replace Words in Content on Display",
"description": "Swaps words or phrases in post titles, content and excerpts when pages are shown, without editing the posts. Useful after a rebrand or a product rename.",
"category": "content",
"tags": [
"replace",
"rebrand",
"text"
],
"code_type": "php",
"insert_method": "auto",
"location": "frontend_only",
"insert_number": 1,
"code": "// Text to find => replacement.\n$wpide_replacements = array(\n 'Old Brand Name' => 'New Brand Name',\n 'old-product' => 'new-product',\n);\n\n$wpide_replace_text = function ( $text ) use ( $wpide_replacements ) {\n if ( ! is_string( $text ) || '' === $text || is_admin() ) {\n return $text;\n }\n\n foreach ( $wpide_replacements as $find => $replace ) {\n $result = preg_replace( '/' . preg_quote( $find, '/' ) . '(?![^<]*>)/u', str_replace( array( '\\\\', '$' ), array( '\\\\\\\\', '\\\\$' ), $replace ), $text );\n $text = null === $result ? $text : $result;\n }\n\n return $text;\n};\n\nadd_filter( 'the_title', $wpide_replace_text );\nadd_filter( 'the_content', $wpide_replace_text, 30 );\nadd_filter( 'the_excerpt', $wpide_replace_text );",
"requires": [],
"notes": "Replacements are case-sensitive and skip HTML tags and attributes. The text saved in the database is not changed."
},
{
"id": "automatic-keyword-links",
"version": 1,
"title": "Automatic Internal Links for Keywords",
"description": "Turns the first mention of chosen keywords in each post into a link to the page you pick, building internal links without editing every post.",
"category": "content",
"tags": [
"internal-links",
"keywords",
"seo"
],
"code_type": "php",
"insert_method": "auto",
"location": "frontend_only",
"insert_number": 1,
"code": "// Keyword => URL (full URL or a path on this site). Examples:\n// 'contact us' => '/contact/',\n// 'our services' => '/services/',\n$wpide_keyword_links = array();\n\nadd_filter( 'the_content', function ( $content ) use ( $wpide_keyword_links ) {\n if ( ! $wpide_keyword_links || ! is_singular() || ! in_the_loop() || ! is_main_query() ) {\n return $content;\n }\n\n $current = untrailingslashit( (string) get_permalink() );\n $parts = preg_split( '/(<[^>]+>)/', $content, -1, PREG_SPLIT_DELIM_CAPTURE );\n $depth = 0;\n $done = array();\n $tokens = array();\n\n foreach ( $parts as $i => $part ) {\n if ( '' === $part ) {\n continue;\n }\n\n if ( '<' === $part[0] ) {\n if ( preg_match( '/^<(a|h[1-6]|code|pre|script|style|button|textarea)[\\s>]/i', $part ) ) {\n $depth++;\n } elseif ( preg_match( '/^<\\/(a|h[1-6]|code|pre|script|style|button|textarea)>/i', $part ) ) {\n $depth = max( 0, $depth - 1 );\n }\n continue;\n }\n\n if ( $depth ) {\n continue;\n }\n\n foreach ( $wpide_keyword_links as $keyword => $url ) {\n if ( isset( $done[ $keyword ] ) ) {\n continue;\n }\n\n $href = preg_match( '#^https?://#', $url ) ? $url : home_url( $url );\n\n if ( untrailingslashit( $href ) === $current ) {\n $done[ $keyword ] = true;\n continue;\n }\n\n $new = preg_replace_callback( '/\\b(' . preg_quote( $keyword, '/' ) . ')\\b/iu', function ( $m ) use ( $href, &$tokens ) {\n $tokens[] = '' . $m[1] . '';\n\n return \"\\x01\" . ( count( $tokens ) - 1 ) . \"\\x02\";\n }, $part, 1, $count );\n\n if ( $count && null !== $new ) {\n $parts[ $i ] = $new;\n $part = $new;\n $done[ $keyword ] = true;\n }\n }\n }\n\n $content = implode( '', $parts );\n\n foreach ( $tokens as $index => $link ) {\n $content = str_replace( \"\\x01\" . $index . \"\\x02\", $link, $content );\n }\n\n return $content;\n}, 20 );",
"requires": [],
"notes": "Add your keywords and target pages to the list first; it is empty by default. Links are not added inside headings, existing links, code or buttons, and a post never links to itself."
},
{
"id": "lead-paragraph-style",
"version": 1,
"title": "Larger Lead Paragraph on Posts",
"description": "Makes the first paragraph of every blog post slightly larger, a classic magazine touch that draws readers into the article.",
"category": "content",
"tags": [
"typography",
"paragraph",
"posts"
],
"code_type": "php",
"insert_method": "auto",
"location": "frontend_only",
"insert_number": 1,
"code": "add_filter( 'the_content', function ( $content ) {\n if ( ! is_singular( 'post' ) || ! in_the_loop() || ! is_main_query() ) {\n return $content;\n }\n\n $result = preg_replace_callback( '/])([^>]*)>/i', function ( $m ) {\n if ( preg_match( '/\\sclass=([\"\\'])/i', $m[1] ) ) {\n return '';\n }\n\n return '
';\n }, $content, 1 );\n\n return null === $result ? $content : $result;\n}, 20 );\n\nadd_action( 'wp_head', function () {\n if ( is_singular( 'post' ) ) {\n echo '' . \"\\n\";\n }\n} );",
"requires": [],
"notes": "Change the font size in the style rule at the bottom of the snippet."
},
{
"id": "drop-cap-on-posts",
"version": 1,
"title": "Automatic Drop Cap on Posts",
"description": "Styles the first letter of every blog post as a large decorative drop cap, without having to switch it on block by block.",
"category": "content",
"tags": [
"typography",
"drop-cap",
"css"
],
"code_type": "css",
"insert_method": "auto",
"location": "site_wide_header",
"insert_number": 1,
"code": ".single-post .wp-block-post-content > p:first-of-type::first-letter,\n.single-post .entry-content > p:first-of-type::first-letter {\n float: left;\n margin: 0.06em 0.12em 0 0;\n font-size: 3.6em;\n line-height: 0.85;\n font-weight: 700;\n}",
"requires": [],
"notes": "Selectors cover block themes and most classic themes; adjust them if your theme uses different content classes."
},
{
"id": "minimum-word-count-to-publish",
"version": 1,
"title": "Minimum Word Count to Publish Posts",
"description": "Stops posts shorter than a minimum number of words from being published, in both the block editor and the classic editor, to keep thin content off the site.",
"category": "content",
"tags": [
"editorial",
"word-count",
"publishing"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Minimum number of words a post needs before it can be published.\n$wpide_min_words = 300;\n\n$wpide_count_words = function ( $content ) {\n return count( preg_split( '/\\s+/u', trim( wp_strip_all_tags( strip_shortcodes( (string) $content ) ) ), -1, PREG_SPLIT_NO_EMPTY ) );\n};\n\nadd_filter( 'rest_pre_insert_post', function ( $prepared, $request ) use ( $wpide_min_words, $wpide_count_words ) {\n $post_id = isset( $prepared->ID ) ? (int) $prepared->ID : 0;\n $status = isset( $prepared->post_status ) ? $prepared->post_status : ( $post_id ? get_post_status( $post_id ) : 'draft' );\n\n if ( ! in_array( $status, array( 'publish', 'future' ), true ) ) {\n return $prepared;\n }\n\n $content = isset( $prepared->post_content ) ? $prepared->post_content : ( $post_id ? get_post_field( 'post_content', $post_id ) : '' );\n\n if ( $wpide_count_words( $content ) < $wpide_min_words ) {\n return new WP_Error( 'wpide_too_short', sprintf( 'This post needs at least %d words before it can be published.', $wpide_min_words ), array( 'status' => 400 ) );\n }\n\n return $prepared;\n}, 10, 2 );\n\nadd_filter( 'wp_insert_post_data', function ( $data ) use ( $wpide_min_words, $wpide_count_words ) {\n if ( ! is_admin() || ( defined( 'REST_REQUEST' ) && REST_REQUEST ) || 'post' !== $data['post_type'] || 'publish' !== $data['post_status'] ) {\n return $data;\n }\n\n if ( $wpide_count_words( wp_unslash( $data['post_content'] ) ) < $wpide_min_words ) {\n $data['post_status'] = 'draft';\n\n add_filter( 'redirect_post_location', function ( $location ) {\n return add_query_arg( 'wpide_too_short', 1, remove_query_arg( 'message', $location ) );\n } );\n }\n\n return $data;\n} );\n\nadd_action( 'admin_notices', function () use ( $wpide_min_words ) {\n if ( isset( $_GET['wpide_too_short'] ) ) {\n echo '
' . esc_html( sprintf( 'The post was saved as a draft because it has fewer than %d words.', $wpide_min_words ) ) . '
';\n }\n} );",
"requires": [],
"notes": "Drafts can still be saved at any length. Change the minimum at the top of the snippet."
},
{
"id": "default-content-for-new-posts",
"version": 1,
"title": "Starter Text for New Posts",
"description": "Fills the editor of every new post with your own starter text or outline, so writers begin from the same structure each time.",
"category": "content",
"tags": [
"editor",
"template",
"posts"
],
"code_type": "php",
"insert_method": "auto",
"location": "admin_only",
"insert_number": 1,
"code": "// Post type that gets the starter text.\n$wpide_starter_post_type = 'post';\n// Starter content (HTML or block markup).\n$wpide_starter_content = '
Introduction: what will the reader learn?
\n\n
Main point
\n\n
Explain the main idea here.
\n\n
Summary
';\n\nadd_filter( 'default_content', function ( $content, $post ) use ( $wpide_starter_post_type, $wpide_starter_content ) {\n if ( '' !== $content || ! $post || $wpide_starter_post_type !== $post->post_type ) {\n return $content;\n }\n\n return $wpide_starter_content;\n}, 10, 2 );",
"requires": [],
"notes": "Change the post type or the starter HTML. Existing posts are not affected."
},
{
"id": "footnotes-shortcode",
"version": 1,
"title": "Footnotes Shortcode",
"description": "Adds a [ref] shortcode for footnotes: each note becomes a numbered superscript link, and all notes are listed at the end of the post with links back.",
"category": "content",
"tags": [
"shortcode",
"footnotes",
"references"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "$wpide_footnotes = array();\n\nadd_shortcode( 'ref', function ( $atts, $content = '' ) use ( &$wpide_footnotes ) {\n $post_id = (int) get_the_ID();\n $content = trim( (string) $content );\n\n if ( '' === $content ) {\n return '';\n }\n\n $wpide_footnotes[ $post_id ][] = $content;\n $number = count( $wpide_footnotes[ $post_id ] );\n $id = $post_id . '-' . $number;\n\n return '' . $number . '';\n} );\n\nadd_filter( 'the_content', function ( $content ) use ( &$wpide_footnotes ) {\n $post_id = (int) get_the_ID();\n\n if ( empty( $wpide_footnotes[ $post_id ] ) ) {\n return $content;\n }\n\n $html = '';\n\n foreach ( $wpide_footnotes[ $post_id ] as $index => $note ) {\n $id = $post_id . '-' . ( $index + 1 );\n $html .= '
';\n} );",
"requires": [],
"notes": "Example: [toggle title=\"What is included?\" open=\"no\"]Answer here.[/toggle]."
},
{
"id": "email-protection-shortcode",
"version": 1,
"title": "Spam-Protected Email Shortcode",
"description": "Adds an [email] shortcode that prints a clickable email address encoded so simple spam bots cannot harvest it.",
"category": "content",
"tags": [
"shortcode",
"email",
"spam"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_shortcode( 'email', function ( $atts, $content = '' ) {\n $atts = shortcode_atts( array( 'address' => '', 'label' => '' ), $atts, 'email' );\n $address = sanitize_email( '' !== $atts['address'] ? $atts['address'] : wp_strip_all_tags( (string) $content ) );\n\n if ( ! is_email( $address ) ) {\n return '';\n }\n\n $label = '' !== $atts['label'] ? esc_html( $atts['label'] ) : antispambot( $address );\n\n return '' . $label . '';\n} );",
"requires": [],
"notes": "Example: [email]hello@example.com[/email] or [email address=\"hello@example.com\" label=\"Email us\"]."
},
{
"id": "relative-post-dates",
"version": 1,
"title": "Show Recent Post Dates as \"2 Days Ago\"",
"description": "Displays the publish date of recent posts in a friendly relative format, such as \"3 hours ago\", and switches back to the normal date after a set number of days.",
"category": "content",
"tags": [
"dates",
"posts",
"display"
],
"code_type": "php",
"insert_method": "auto",
"location": "frontend_only",
"insert_number": 1,
"code": "// Use relative dates for posts newer than this many days.\n$wpide_relative_days = 7;\n\nadd_filter( 'get_the_date', function ( $date, $format, $post ) use ( $wpide_relative_days ) {\n if ( is_admin() || is_feed() || ( '' !== $format && get_option( 'date_format' ) !== $format ) ) {\n return $date;\n }\n\n $timestamp = (int) get_post_time( 'U', true, $post );\n\n if ( ! $timestamp || time() - $timestamp > $wpide_relative_days * DAY_IN_SECONDS || $timestamp > time() ) {\n return $date;\n }\n\n return sprintf( '%s ago', human_time_diff( $timestamp, time() ) );\n}, 10, 3 );",
"requires": [],
"notes": "Machine-readable dates in datetime attributes are left untouched. Change the day limit at the top."
},
{
"id": "custom-more-tag-link",
"version": 1,
"title": "Change the \"Read More\" Tag Link",
"description": "Changes the text of the link created by the More block and stops it from jumping halfway down the post when clicked.",
"category": "content",
"tags": [
"read-more",
"excerpts",
"links"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Link text.\n$wpide_more_text = 'Keep reading →';\n// Keep the jump to the #more-123 anchor.\n$wpide_more_jump = false;\n\nadd_filter( 'the_content_more_link', function ( $link ) use ( $wpide_more_text, $wpide_more_jump ) {\n $url = get_permalink();\n\n if ( $wpide_more_jump ) {\n $url .= '#more-' . get_the_ID();\n }\n\n return '' . wp_kses_post( $wpide_more_text ) . '';\n} );",
"requires": [],
"notes": "Set $wpide_more_text to your own wording. Set $wpide_more_jump to true to keep the jump to the #more anchor."
},
{
"id": "password-form-message",
"version": 1,
"title": "Custom Message on Password-Protected Posts",
"description": "Replaces the standard \"This content is password protected\" sentence with your own message, for example explaining how to get the password.",
"category": "content",
"tags": [
"password",
"protected",
"message"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Message shown above the password field.\n$wpide_password_message = 'This page is for clients only. Enter the password from your welcome email to continue.';\n\nadd_filter( 'the_password_form', function ( $output ) use ( $wpide_password_message ) {\n $result = preg_replace( '/
', $output, 1 );\n\n return null === $result ? $output : $result;\n} );",
"requires": [],
"notes": "Basic HTML such as links is allowed in the message."
},
{
"id": "remove-protected-private-title-prefix",
"version": 1,
"title": "Remove \"Protected:\" and \"Private:\" From Titles",
"description": "Drops the \"Protected:\" and \"Private:\" words WordPress adds in front of the titles of password-protected and private posts.",
"category": "content",
"tags": [
"titles",
"private",
"protected"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_filter( 'protected_title_format', function () {\n return '%s';\n} );\n\nadd_filter( 'private_title_format', function () {\n return '%s';\n} );",
"requires": [],
"notes": ""
},
{
"id": "hide-title-on-selected-pages",
"version": 1,
"title": "Hide the Title on Selected Pages",
"description": "Removes the page title on the pages you list, such as a landing page or the homepage, while keeping it in menus, the browser tab and search results.",
"category": "content",
"tags": [
"titles",
"pages",
"landing-page"
],
"code_type": "php",
"insert_method": "auto",
"location": "frontend_only",
"insert_number": 1,
"code": "// IDs of the pages whose title should be hidden.\n$wpide_hidden_title_ids = array( 0 );\n\nadd_filter( 'the_title', function ( $title, $id = 0 ) use ( $wpide_hidden_title_ids ) {\n if ( is_admin() || ! $id || ! in_the_loop() || ! is_singular() || (int) $id !== get_queried_object_id() ) {\n return $title;\n }\n\n return in_array( (int) $id, array_map( 'intval', $wpide_hidden_title_ids ), true ) ? '' : $title;\n}, 10, 2 );",
"requires": [],
"notes": "Add the page IDs to the list. Some themes print the title outside the main loop, in which case hide it with CSS instead."
},
{
"id": "clickable-urls-in-content",
"version": 1,
"title": "Turn Plain URLs Into Links",
"description": "Converts web addresses and email addresses typed as plain text in posts into clickable links.",
"category": "content",
"tags": [
"links",
"urls",
"content"
],
"code_type": "php",
"insert_method": "auto",
"location": "frontend_only",
"insert_number": 1,
"code": "add_filter( 'the_content', 'make_clickable', 12 );",
"requires": [],
"notes": "Text inside existing links, code and preformatted blocks is left alone."
},
{
"id": "new-badge-on-recent-posts",
"version": 1,
"title": "\"New\" Badge on Recent Post Titles",
"description": "Adds a small \"New\" label next to the titles of posts published in the last few days on your blog and archive pages.",
"category": "content",
"tags": [
"badge",
"posts",
"archives"
],
"code_type": "php",
"insert_method": "auto",
"location": "frontend_only",
"insert_number": 1,
"code": "// Posts newer than this many days get the badge.\n$wpide_new_badge_days = 7;\n// Badge text.\n$wpide_new_badge_text = 'New';\n\nadd_filter( 'the_title', function ( $title, $id = 0 ) use ( $wpide_new_badge_days, $wpide_new_badge_text ) {\n if ( is_admin() || is_feed() || is_singular() || ! in_the_loop() || ! $id || 'post' !== get_post_type( $id ) ) {\n return $title;\n }\n\n $published = (int) get_post_time( 'U', true, $id );\n\n if ( $published && time() - $published < $wpide_new_badge_days * DAY_IN_SECONDS ) {\n $title .= ' ' . esc_html( $wpide_new_badge_text ) . '';\n }\n\n return $title;\n}, 10, 2 );",
"requires": [],
"notes": "Change the number of days or the label text. Themes that use the title inside an HTML attribute will show the word as plain text there."
},
{
"id": "unpublish-posts-on-date",
"version": 1,
"title": "Unpublish Posts on an Expiry Date",
"description": "Adds an \"Unpublish on\" date box to the post editor and moves expired posts back to draft automatically, for time-limited offers and announcements.",
"category": "content",
"tags": [
"expiry",
"schedule",
"posts"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'add_meta_boxes', function () {\n add_meta_box( 'wpide-expiry', 'Unpublish on', function ( $post ) {\n wp_nonce_field( 'wpide_expiry_save', 'wpide_expiry_nonce' );\n $value = get_post_meta( $post->ID, 'wpide_expires', true );\n echo '';\n echo '';\n echo '
Leave empty to keep the post published.
';\n }, 'post', 'side' );\n} );\n\nadd_action( 'save_post_post', function ( $post_id ) {\n if ( ! isset( $_POST['wpide_expiry_nonce'] ) || ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['wpide_expiry_nonce'] ) ), 'wpide_expiry_save' ) ) {\n return;\n }\n\n if ( ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) || ! current_user_can( 'edit_post', $post_id ) ) {\n return;\n }\n\n $value = isset( $_POST['wpide_expires'] ) ? sanitize_text_field( wp_unslash( $_POST['wpide_expires'] ) ) : '';\n\n if ( preg_match( '/^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$/', $value ) ) {\n update_post_meta( $post_id, 'wpide_expires', $value );\n } else {\n delete_post_meta( $post_id, 'wpide_expires' );\n }\n} );\n\nadd_action( 'init', function () {\n if ( ! wp_next_scheduled( 'wpide_unpublish_expired_posts' ) ) {\n wp_schedule_event( time() + 300, 'hourly', 'wpide_unpublish_expired_posts' );\n }\n} );\n\nadd_action( 'wpide_unpublish_expired_posts', function () {\n $expired = get_posts( array(\n 'post_type' => 'post',\n 'post_status' => 'publish',\n 'fields' => 'ids',\n 'numberposts' => 50,\n 'meta_query' => array(\n array( 'key' => 'wpide_expires', 'value' => '', 'compare' => '!=' ),\n array( 'key' => 'wpide_expires', 'value' => current_time( 'Y-m-d\\TH:i' ), 'compare' => '<=' ),\n ),\n ) );\n\n foreach ( $expired as $post_id ) {\n wp_update_post( array( 'ID' => $post_id, 'post_status' => 'draft' ) );\n }\n} );",
"requires": [],
"notes": "A check runs every hour with WP-Cron, so posts expire within an hour of the chosen time. Dates use the site time zone."
},
{
"id": "mid-article-call-to-action",
"version": 1,
"title": "Call to Action in the Middle of Posts",
"description": "Places a call-to-action box halfway through each post, where readers who are engaged are most likely to notice it.",
"category": "content",
"tags": [
"cta",
"content",
"conversion"
],
"code_type": "html",
"insert_method": "auto",
"location": "content_half",
"insert_number": 1,
"code": "
\n
Want the full checklist?
\n
Download the free PDF version of this guide and keep it handy.
",
"requires": [],
"notes": "Replace the heading, text and link with your own offer."
},
{
"id": "repeating-ad-every-350-words",
"version": 1,
"title": "Repeating Ad Slot Every 350 Words",
"description": "Inserts your ad code after every 350 words of a post, at paragraph boundaries, so long articles earn more without manual placement.",
"category": "content",
"tags": [
"ads",
"monetization",
"content"
],
"code_type": "html",
"insert_method": "auto",
"location": "every_words",
"insert_number": 350,
"code": "
\n \n
Advertisement
\n
",
"requires": [],
"notes": "Change the word count in the snippet settings and paste your ad network code in place of the placeholder."
},
{
"id": "read-next-link-in-content",
"version": 1,
"title": "\"Read Next\" Link Two Thirds Into Posts",
"description": "Adds a \"Read next\" link to another post from the same category two thirds of the way through each article, keeping readers on your site.",
"category": "content",
"tags": [
"internal-links",
"engagement",
"related"
],
"code_type": "universal",
"insert_method": "auto",
"location": "content_two_thirds",
"insert_number": 1,
"code": " wp_get_post_categories( get_the_ID() ),\n 'post__not_in' => array( get_the_ID() ),\n 'numberposts' => 1,\n 'ignore_sticky_posts' => true,\n 'no_found_rows' => true,\n) );\n\nif ( $wpide_read_next ) : ?>\n
\n",
"requires": [],
"notes": "The suggestion is the newest other post in the same category; nothing is shown if there is none."
},
{
"id": "author-cta-block-after-posts",
"version": 1,
"title": "Call-to-Action Group Block After Posts",
"description": "Adds a ready-made group of blocks (heading, text and button) to the end of every post, which you can restyle with the block editor's own classes.",
"category": "content",
"tags": [
"blocks",
"cta",
"posts"
],
"code_type": "blocks",
"insert_method": "auto",
"location": "after_content",
"insert_number": 1,
"code": "\n
\n
Need help with your project?
\n\n\n\n
Tell us what you are working on and we will get back to you within one business day.
';\n}, 1 );",
"requires": [],
"notes": "The excerpt length and the link text follow your excerpt settings and other excerpt snippets."
},
{
"id": "styled-blockquotes-scss",
"version": 1,
"title": "Elegant Blockquote Styles (SCSS)",
"description": "Gives quotes in your posts a refined look with a large quotation mark, an accent border and a styled citation line.",
"category": "content",
"tags": [
"scss",
"quotes",
"typography"
],
"code_type": "scss",
"insert_method": "auto",
"location": "site_wide_header",
"insert_number": 1,
"code": "$accent: #2271b1;\n$quote-size: 1.15em;\n\n.entry-content,\n.wp-block-post-content {\n blockquote,\n .wp-block-quote {\n position: relative;\n margin: 2em 0;\n padding: 0.5em 1.5em 0.5em 2.25em;\n border-left: 4px solid $accent;\n font-size: $quote-size;\n font-style: italic;\n\n &::before {\n content: \"\\201C\";\n position: absolute;\n top: -0.15em;\n left: 0.25em;\n font-size: 3em;\n line-height: 1;\n color: rgba($accent, 0.35);\n }\n\n p:last-of-type {\n margin-bottom: 0;\n }\n\n cite {\n display: block;\n margin-top: 0.75em;\n font-size: 0.8em;\n font-style: normal;\n opacity: 0.75;\n\n &::before {\n content: \"\\2014\\00a0\";\n }\n }\n }\n}",
"requires": [],
"notes": "Change the $accent variable to your brand color."
},
{
"id": "content-table-styles-scss",
"version": 1,
"title": "Clean Table Styles for Posts (SCSS)",
"description": "Gives tables in posts and pages a clean, readable look with a bold header row, light striping, comfortable padding and horizontal scrolling on phones.",
"category": "content",
"tags": [
"scss",
"tables",
"typography"
],
"code_type": "scss",
"insert_method": "auto",
"location": "site_wide_header",
"insert_number": 1,
"code": "$header-bg: #f0f0f1;\n$stripe: rgba(0, 0, 0, 0.03);\n$border: rgba(0, 0, 0, 0.12);\n\n.entry-content,\n.wp-block-post-content {\n table {\n width: 100%;\n border-collapse: collapse;\n font-size: 0.95em;\n }\n\n th,\n td {\n padding: 0.6em 0.9em;\n border: 1px solid $border;\n text-align: left;\n vertical-align: top;\n }\n\n thead th,\n tr:first-child th {\n background: $header-bg;\n font-weight: 600;\n }\n\n tbody tr:nth-child(even) {\n background: $stripe;\n }\n\n @media (max-width: 600px) {\n table {\n display: block;\n overflow-x: auto;\n white-space: nowrap;\n }\n }\n}",
"requires": [],
"notes": "Change $header-bg and $stripe to match your theme."
},
{
"id": "readable-post-typography-scss",
"version": 1,
"title": "Comfortable Reading Typography for Posts (SCSS)",
"description": "Tunes the line length, line height and spacing of headings, paragraphs and lists inside blog posts for long-form reading.",
"category": "content",
"tags": [
"scss",
"typography",
"readability"
],
"code_type": "scss",
"insert_method": "auto",
"location": "site_wide_header",
"insert_number": 1,
"code": "$measure: 68ch;\n$line-height: 1.7;\n$flow: 1.25em;\n\n.single-post {\n .entry-content,\n .wp-block-post-content {\n line-height: $line-height;\n\n > p,\n > ul,\n > ol,\n > blockquote {\n max-width: $measure;\n }\n\n > * + * {\n margin-top: $flow;\n }\n\n h2,\n h3,\n h4 {\n margin-top: $flow * 2;\n margin-bottom: $flow * 0.5;\n line-height: 1.25;\n }\n\n li + li {\n margin-top: 0.4em;\n }\n }\n}",
"requires": [],
"notes": "The measure limits the width of text blocks; wide and full-width blocks are not affected."
},
{
"id": "styled-code-blocks-scss",
"version": 1,
"title": "Styled Code Blocks (SCSS)",
"description": "Gives code blocks and inline code in your posts a dark, readable style with rounded corners, a monospace font stack and horizontal scrolling for long lines.",
"category": "content",
"tags": [
"scss",
"code",
"developer"
],
"code_type": "scss",
"insert_method": "auto",
"location": "site_wide_header",
"insert_number": 1,
"code": "$code-bg: #1e1e2e;\n$code-fg: #e4e4ef;\n$inline-bg: rgba(0, 0, 0, 0.06);\n$mono: ui-monospace, SFMono-Regular, Menlo, Consolas, \"Liberation Mono\", monospace;\n\n.entry-content,\n.wp-block-post-content {\n pre,\n .wp-block-code {\n overflow-x: auto;\n padding: 1em 1.25em;\n border-radius: 8px;\n background: $code-bg;\n color: $code-fg;\n font-family: $mono;\n font-size: 0.875em;\n line-height: 1.6;\n\n code {\n padding: 0;\n background: none;\n color: inherit;\n }\n }\n\n :not(pre) > code {\n padding: 0.15em 0.4em;\n border-radius: 4px;\n background: $inline-bg;\n font-family: $mono;\n font-size: 0.9em;\n }\n}",
"requires": [],
"notes": "Pairs well with the Copy Button on Code Blocks snippet."
},
{
"id": "key-takeaways-block-before-content",
"version": 1,
"title": "Key Takeaways Box Before Posts (Blocks)",
"description": "Adds a \"Key takeaways\" box built from blocks at the top of every post, a skimmable summary readers and search engines appreciate.",
"category": "content",
"tags": [
"blocks",
"summary",
"posts"
],
"code_type": "blocks",
"insert_method": "auto",
"location": "before_content",
"insert_number": 1,
"code": "\n
\n
Key takeaways
\n\n\n\n
\n
The most important point of the article.
\n\n\n\n
A second insight readers should remember.
\n\n\n\n
What to do next.
\n
\n
\n",
"requires": [],
"notes": "Edit the list in the snippet editor; for per-post summaries, duplicate the snippet and limit it with conditions."
},
{
"id": "newsletter-prompt-after-300-words",
"version": 1,
"title": "Newsletter Prompt After 300 Words",
"description": "Shows a short newsletter invitation once readers are about 300 words into a post, after they have shown real interest but before most people stop scrolling.",
"category": "content",
"tags": [
"newsletter",
"cta",
"content"
],
"code_type": "html",
"insert_method": "auto",
"location": "after_words",
"insert_number": 300,
"code": "",
"requires": [],
"notes": "Change the word count in the snippet settings and the link to your sign-up page."
},
{
"id": "sponsor-message-at-80-percent",
"version": 1,
"title": "Sponsor Message Near the End of Posts",
"description": "Places a sponsor or partner message 80% of the way through each post, where it reaches readers who are almost finished without interrupting the start.",
"category": "content",
"tags": [
"sponsors",
"monetization",
"content"
],
"code_type": "html",
"insert_method": "auto",
"location": "content_80",
"insert_number": 1,
"code": "",
"requires": [],
"notes": "Replace the text, logo and link with your sponsor's details and keep the \"Sponsored\" label for transparency."
},
{
"id": "ad-slot-after-first-quarter",
"version": 1,
"title": "Ad Slot After the First Quarter of Posts",
"description": "Inserts your ad code after the first quarter of each post's content, a placement that tends to perform well without pushing the article down.",
"category": "content",
"tags": [
"ads",
"monetization",
"content"
],
"code_type": "html",
"insert_method": "auto",
"location": "content_quarter",
"insert_number": 1,
"code": "
\n \n
Advertisement
\n
",
"requires": [],
"notes": "Paste your ad network code in place of the placeholder."
},
{
"id": "posts-per-page-for-post-type-archives",
"version": 1,
"title": "Posts per Page for Custom Post Type Archives",
"description": "Sets how many entries each custom post type archive shows, separately from the blog setting, for example 12 portfolio items or every testimonial on one page.",
"category": "archive",
"tags": [
"post-types",
"pagination",
"archives"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Post type => number per page (-1 = all).\n$wpide_archive_per_page = array(\n 'portfolio' => 12,\n 'testimonial' => -1,\n);\n\nadd_action( 'pre_get_posts', function ( $query ) use ( $wpide_archive_per_page ) {\n if ( is_admin() || ! $query->is_main_query() || ! $query->is_post_type_archive() ) {\n return;\n }\n\n foreach ( $wpide_archive_per_page as $post_type => $count ) {\n if ( $query->is_post_type_archive( $post_type ) ) {\n $query->set( 'posts_per_page', (int) $count );\n return;\n }\n }\n} );",
"requires": [],
"notes": "Use -1 to show all entries on one page. WooCommerce products have their own setting and should not be listed here."
},
{
"id": "order-posts-by-last-modified",
"version": 1,
"title": "Order Blog and Archives by Last Updated",
"description": "Lists posts on the blog page and archives by the date they were last updated instead of the date they were published, so refreshed articles move back to the top.",
"category": "archive",
"tags": [
"order",
"archives",
"modified-date"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'pre_get_posts', function ( $query ) {\n if ( is_admin() || ! $query->is_main_query() || ! ( $query->is_home() || $query->is_archive() ) || $query->get( 'orderby' ) ) {\n return;\n }\n\n $query->set( 'orderby', 'modified' );\n $query->set( 'order', 'DESC' );\n} );",
"requires": [],
"notes": ""
},
{
"id": "random-order-for-post-type-archive",
"version": 1,
"title": "Random Order on a Post Type Archive",
"description": "Shows the entries of selected post types, such as testimonials or team members, in a random order on each visit.",
"category": "archive",
"tags": [
"random",
"post-types",
"archives"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Post types whose archive is shuffled.\n$wpide_random_post_types = array( 'testimonial' );\n\nadd_action( 'pre_get_posts', function ( $query ) use ( $wpide_random_post_types ) {\n if ( is_admin() || ! $query->is_main_query() || ! $query->is_post_type_archive( $wpide_random_post_types ) ) {\n return;\n }\n\n $query->set( 'orderby', 'rand' );\n} );",
"requires": [],
"notes": "Random order works best when all entries fit on one page; with pagination, items can repeat across pages. Page caching keeps the same order until the cache clears."
},
{
"id": "upcoming-events-archive",
"version": 1,
"title": "Upcoming Events Archive Sorted by Event Date",
"description": "Orders an events post type archive by the event date stored in a custom field, soonest first, and hides events that have already happened.",
"category": "archive",
"tags": [
"events",
"custom-fields",
"order"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Events post type and the custom field that holds the event date (YYYY-MM-DD).\n$wpide_event_post_type = 'event';\n$wpide_event_date_key = 'event_date';\n\nadd_action( 'pre_get_posts', function ( $query ) use ( $wpide_event_post_type, $wpide_event_date_key ) {\n if ( is_admin() || ! $query->is_main_query() || ! $query->is_post_type_archive( $wpide_event_post_type ) ) {\n return;\n }\n\n $query->set( 'meta_query', array(\n 'wpide_event_date' => array(\n 'key' => $wpide_event_date_key,\n 'value' => current_time( 'Y-m-d' ),\n 'compare' => '>=',\n 'type' => 'DATE',\n ),\n ) );\n $query->set( 'orderby', 'wpide_event_date' );\n $query->set( 'order', 'ASC' );\n} );",
"requires": [],
"notes": "Set the post type and the custom field name. The field must hold dates as YYYY-MM-DD."
},
{
"id": "custom-archive-title-wording",
"version": 1,
"title": "Custom Wording for Archive Titles",
"description": "Rewrites archive headings with your own wording, such as \"Articles by Jane\" on author pages or \"Posts from March 2026\" on monthly archives.",
"category": "archive",
"tags": [
"archives",
"titles",
"wording"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Title templates. %s is replaced with the term, author or date.\n$wpide_archive_titles = array(\n 'category' => '%s',\n 'tag' => 'Posts tagged \"%s\"',\n 'author' => 'Articles by %s',\n 'year' => 'Posts from %s',\n 'month' => 'Posts from %s',\n 'day' => 'Posts from %s',\n);\n\nadd_filter( 'get_the_archive_title', function ( $title ) use ( $wpide_archive_titles ) {\n if ( is_category() ) {\n return sprintf( $wpide_archive_titles['category'], single_cat_title( '', false ) );\n }\n\n if ( is_tag() ) {\n return sprintf( $wpide_archive_titles['tag'], single_tag_title( '', false ) );\n }\n\n if ( is_author() ) {\n return sprintf( $wpide_archive_titles['author'], get_the_author_meta( 'display_name', get_queried_object_id() ) );\n }\n\n if ( is_day() ) {\n return sprintf( $wpide_archive_titles['day'], get_the_date() );\n }\n\n if ( is_month() ) {\n return sprintf( $wpide_archive_titles['month'], get_the_date( 'F Y' ) );\n }\n\n if ( is_year() ) {\n return sprintf( $wpide_archive_titles['year'], get_the_date( 'Y' ) );\n }\n\n return $title;\n}, 20 );",
"requires": [],
"notes": "Edit the templates at the top; %s is replaced with the name or date."
},
{
"id": "exclude-posts-from-blog-page",
"version": 1,
"title": "Hide Specific Posts From the Blog Page",
"description": "Keeps the posts you list off the main blog page and its pagination while they stay reachable through their own URL, categories and search.",
"category": "archive",
"tags": [
"blog",
"exclude",
"homepage"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// IDs of posts to keep off the blog page.\n$wpide_hidden_from_blog = array( 0 );\n\nadd_action( 'pre_get_posts', function ( $query ) use ( $wpide_hidden_from_blog ) {\n if ( is_admin() || ! $query->is_main_query() || ! $query->is_home() ) {\n return;\n }\n\n $query->set( 'post__not_in', array_merge( (array) $query->get( 'post__not_in' ), array_map( 'absint', $wpide_hidden_from_blog ) ) );\n} );",
"requires": [],
"notes": "Add the post IDs to the list."
},
{
"id": "blog-page-only-selected-categories",
"version": 1,
"title": "Show Only Selected Categories on the Blog Page",
"description": "Limits the main blog page to posts from the categories you choose, for example only News, while other categories keep their own archives.",
"category": "archive",
"tags": [
"blog",
"categories",
"homepage"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Category slugs to show on the blog page, for example array( 'news' ).\n$wpide_blog_categories = array();\n\nadd_action( 'pre_get_posts', function ( $query ) use ( $wpide_blog_categories ) {\n if ( is_admin() || ! $query->is_main_query() || ! $query->is_home() || ! $wpide_blog_categories ) {\n return;\n }\n\n $query->set( 'category_name', implode( ',', array_map( 'sanitize_title', $wpide_blog_categories ) ) );\n} );",
"requires": [],
"notes": "The list is empty by default, which changes nothing. Add category slugs; posts from other categories still appear in their archives, search and feeds."
},
{
"id": "redirect-single-post-archives",
"version": 1,
"title": "Skip Category and Tag Pages With Only One Post",
"description": "Sends visitors straight to the post when a category or tag archive contains just one post, saving them a pointless extra click.",
"category": "archive",
"tags": [
"archives",
"redirect",
"categories"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'template_redirect', function () {\n global $wp_query;\n\n if ( ! ( is_category() || is_tag() ) || is_paged() || is_feed() ) {\n return;\n }\n\n if ( 1 === (int) $wp_query->found_posts && ! empty( $wp_query->posts[0] ) ) {\n wp_safe_redirect( get_permalink( $wp_query->posts[0] ), 302 );\n exit;\n }\n} );",
"requires": [],
"notes": "Uses a temporary redirect, so the archive works normally again as soon as a second post is added."
},
{
"id": "empty-term-archives-404",
"version": 1,
"title": "Return 404 for Empty Category and Tag Pages",
"description": "Shows your \"not found\" page with a 404 status for categories, tags and other terms that have no published posts, instead of an empty archive.",
"category": "archive",
"tags": [
"archives",
"404",
"thin-content"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'template_redirect', function () {\n global $wp_query;\n\n if ( ( is_category() || is_tag() || is_tax() ) && ! is_paged() && ! $wp_query->have_posts() ) {\n $wp_query->set_404();\n status_header( 404 );\n nocache_headers();\n }\n}, 1 );",
"requires": [],
"notes": ""
},
{
"id": "exclude-subcategory-posts",
"version": 1,
"title": "Hide Subcategory Posts From Parent Categories",
"description": "Makes a category archive list only the posts assigned directly to that category, not the posts from its child categories.",
"category": "archive",
"tags": [
"categories",
"archives",
"subcategories"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'parse_tax_query', function ( $query ) {\n if ( is_admin() || ! $query->is_main_query() || ! $query->is_category() || empty( $query->tax_query->queries ) ) {\n return;\n }\n\n foreach ( $query->tax_query->queries as $index => $clause ) {\n if ( is_array( $clause ) && isset( $clause['taxonomy'] ) && 'category' === $clause['taxonomy'] ) {\n $query->tax_query->queries[ $index ]['include_children'] = false;\n }\n }\n} );",
"requires": [],
"notes": ""
},
{
"id": "subcategory-links-on-category-archives",
"version": 1,
"title": "Subcategory Links at the Top of Category Archives",
"description": "Shows a row of links to the child categories at the top of a category archive, helping visitors drill down into large sections.",
"category": "archive",
"tags": [
"categories",
"navigation",
"archives"
],
"code_type": "php",
"insert_method": "auto",
"location": "frontend_only",
"insert_number": 1,
"code": "add_action( 'loop_start', function ( $query ) {\n static $done = false;\n\n if ( $done || ! $query->is_main_query() || ! is_category() || is_paged() ) {\n return;\n }\n\n $done = true;\n $children = get_categories( array(\n 'parent' => get_queried_object_id(),\n 'hide_empty' => true,\n ) );\n\n if ( ! $children ) {\n return;\n }\n\n echo '';\n} );",
"requires": [],
"notes": "Only categories with posts are listed. The position depends on where your theme starts the post loop."
},
{
"id": "post-count-in-archive-title",
"version": 1,
"title": "Post Count in Archive Titles",
"description": "Adds the number of posts to category, tag, author and date archive headings, for example \"Recipes (42)\".",
"category": "archive",
"tags": [
"archives",
"titles",
"count"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_filter( 'get_the_archive_title', function ( $title ) {\n global $wp_query;\n\n if ( ! is_archive() || is_post_type_archive() || ! $wp_query instanceof WP_Query ) {\n return $title;\n }\n\n return $title . ' (' . esc_html( number_format_i18n( (int) $wp_query->found_posts ) ) . ')';\n}, 20 );",
"requires": [],
"notes": ""
},
{
"id": "term-description-first-page-only",
"version": 1,
"title": "Show Category Descriptions on the First Page Only",
"description": "Hides category, tag and taxonomy descriptions on page 2 and beyond of an archive, so long intro texts are not repeated on every page.",
"category": "archive",
"tags": [
"archives",
"descriptions",
"pagination"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_filter( 'get_the_archive_description', function ( $description ) {\n return is_paged() ? '' : $description;\n} );",
"requires": [],
"notes": ""
},
{
"id": "archives-list-shortcode",
"version": 1,
"title": "Archives List Shortcode",
"description": "Adds an [archives] shortcode that lists your posts by month or year, as a list or a dropdown, anywhere in content or widgets.",
"category": "archive",
"tags": [
"shortcode",
"archives",
"dates"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_shortcode( 'archives', function ( $atts ) {\n $atts = shortcode_atts( array(\n 'type' => 'monthly',\n 'limit' => '',\n 'show_count' => 'no',\n 'dropdown' => 'no',\n 'post_type' => 'post',\n ), $atts, 'archives' );\n\n $args = array(\n 'type' => in_array( $atts['type'], array( 'yearly', 'monthly', 'weekly', 'daily', 'postbypost', 'alpha' ), true ) ? $atts['type'] : 'monthly',\n 'limit' => $atts['limit'] ? absint( $atts['limit'] ) : '',\n 'show_post_count' => 'yes' === $atts['show_count'],\n 'post_type' => post_type_exists( $atts['post_type'] ) ? $atts['post_type'] : 'post',\n 'echo' => false,\n );\n\n if ( 'yes' === $atts['dropdown'] ) {\n $args['format'] = 'option';\n\n return '';\n }\n\n return '
' . wp_get_archives( $args ) . '
';\n} );",
"requires": [],
"notes": "Example: [archives type=\"yearly\" show_count=\"yes\"] or [archives type=\"monthly\" limit=\"12\" dropdown=\"yes\"]."
},
{
"id": "category-list-shortcode",
"version": 1,
"title": "Category List Shortcode",
"description": "Adds a [category_list] shortcode that prints a linked list of your categories, optionally with post counts and nested subcategories.",
"category": "archive",
"tags": [
"shortcode",
"categories",
"navigation"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_shortcode( 'category_list', function ( $atts ) {\n $atts = shortcode_atts( array(\n 'show_count' => 'no',\n 'hierarchical' => 'yes',\n 'exclude' => '',\n 'taxonomy' => 'category',\n ), $atts, 'category_list' );\n\n $list = wp_list_categories( array(\n 'title_li' => '',\n 'echo' => false,\n 'show_count' => 'yes' === $atts['show_count'],\n 'hierarchical' => 'yes' === $atts['hierarchical'],\n 'exclude' => wp_parse_id_list( $atts['exclude'] ),\n 'taxonomy' => taxonomy_exists( $atts['taxonomy'] ) ? $atts['taxonomy'] : 'category',\n ) );\n\n return '
' . $list . '
';\n} );",
"requires": [],
"notes": "Example: [category_list show_count=\"yes\" exclude=\"1,7\" taxonomy=\"category\"]."
},
{
"id": "tag-cloud-shortcode",
"version": 1,
"title": "Tag Cloud Shortcode",
"description": "Adds a [tag_cloud] shortcode to show a tag cloud inside a page or post, with control over how many tags appear and how large they get.",
"category": "archive",
"tags": [
"shortcode",
"tags",
"tag-cloud"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_shortcode( 'tag_cloud', function ( $atts ) {\n $atts = shortcode_atts( array(\n 'number' => 45,\n 'smallest' => 0.8,\n 'largest' => 1.6,\n 'taxonomy' => 'post_tag',\n 'orderby' => 'name',\n ), $atts, 'tag_cloud' );\n\n $cloud = wp_tag_cloud( array(\n 'number' => absint( $atts['number'] ),\n 'smallest' => (float) $atts['smallest'],\n 'largest' => (float) $atts['largest'],\n 'unit' => 'em',\n 'taxonomy' => taxonomy_exists( $atts['taxonomy'] ) ? $atts['taxonomy'] : 'post_tag',\n 'orderby' => 'count' === $atts['orderby'] ? 'count' : 'name',\n 'order' => 'count' === $atts['orderby'] ? 'DESC' : 'ASC',\n 'echo' => false,\n ) );\n\n return $cloud ? '
' . $cloud . '
' : '';\n} );",
"requires": [],
"notes": "Example: [tag_cloud number=\"30\" smallest=\"0.8\" largest=\"1.6\" taxonomy=\"post_tag\"]. Sizes are in em."
},
{
"id": "custom-post-types-on-author-archives",
"version": 1,
"title": "Include Custom Post Types on Author Archives",
"description": "Lists an author's portfolio items, recipes or other custom post type entries on their author page, not just their blog posts.",
"category": "archive",
"tags": [
"authors",
"post-types",
"archives"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Post types shown on author archives.\n$wpide_author_archive_types = array( 'post', 'portfolio' );\n\nadd_action( 'pre_get_posts', function ( $query ) use ( $wpide_author_archive_types ) {\n if ( is_admin() || ! $query->is_main_query() || ! $query->is_author() ) {\n return;\n }\n\n $query->set( 'post_type', array_values( array_filter( $wpide_author_archive_types, 'post_type_exists' ) ) );\n} );",
"requires": [],
"notes": "Set the post types to include. They must support authors."
},
{
"id": "custom-post-types-on-term-archives",
"version": 1,
"title": "Include Custom Post Types on Category and Tag Archives",
"description": "Makes category and tag archives list custom post type entries that use those categories and tags, not only regular posts.",
"category": "archive",
"tags": [
"categories",
"tags",
"post-types"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Post types shown on category and tag archives.\n$wpide_term_archive_types = array( 'post', 'portfolio' );\n\nadd_action( 'pre_get_posts', function ( $query ) use ( $wpide_term_archive_types ) {\n if ( is_admin() || ! $query->is_main_query() || ! ( $query->is_category() || $query->is_tag() ) || $query->get( 'post_type' ) ) {\n return;\n }\n\n $query->set( 'post_type', array_values( array_filter( $wpide_term_archive_types, 'post_type_exists' ) ) );\n} );",
"requires": [],
"notes": "The custom post type must be registered with the category or post_tag taxonomy."
},
{
"id": "disable-tag-archives",
"version": 1,
"title": "Disable Tag Archives",
"description": "Redirects tag archive pages to the homepage and removes tags from the XML sitemap, for sites that use tags only internally.",
"category": "archive",
"tags": [
"tags",
"archives",
"redirect"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'template_redirect', function () {\n if ( is_tag() ) {\n wp_safe_redirect( home_url( '/' ), 301 );\n exit;\n }\n} );\n\nadd_filter( 'wp_sitemaps_taxonomies', function ( $taxonomies ) {\n unset( $taxonomies['post_tag'] );\n\n return $taxonomies;\n} );",
"requires": [],
"notes": "Your theme may still print tag links on posts; they will redirect to the homepage."
},
{
"id": "disable-post-format-archives",
"version": 1,
"title": "Disable Post Format Archives",
"description": "Redirects the automatic archives for post formats (such as /type/gallery/) to the homepage and removes them from the sitemap.",
"category": "archive",
"tags": [
"post-formats",
"archives",
"redirect"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'template_redirect', function () {\n if ( is_tax( 'post_format' ) ) {\n wp_safe_redirect( home_url( '/' ), 301 );\n exit;\n }\n} );\n\nadd_filter( 'wp_sitemaps_taxonomies', function ( $taxonomies ) {\n unset( $taxonomies['post_format'] );\n\n return $taxonomies;\n} );",
"requires": [],
"notes": ""
},
{
"id": "different-post-count-on-first-blog-page",
"version": 1,
"title": "Different Number of Posts on the First Blog Page",
"description": "Shows a different number of posts on the first page of the blog than on the following pages, for example 3 featured posts up front and 10 per page after that, with pagination still correct.",
"category": "archive",
"tags": [
"blog",
"pagination",
"homepage"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Number of posts on the first page of the blog.\n$wpide_first_page_posts = 3;\n\nadd_action( 'pre_get_posts', function ( $query ) use ( $wpide_first_page_posts ) {\n if ( is_admin() || ! $query->is_main_query() || ! $query->is_home() ) {\n return;\n }\n\n $per_page = (int) get_option( 'posts_per_page' );\n $paged = max( 1, (int) $query->get( 'paged' ) );\n\n if ( 1 === $paged ) {\n $query->set( 'posts_per_page', $wpide_first_page_posts );\n } else {\n $query->set( 'posts_per_page', $per_page );\n $query->set( 'offset', $wpide_first_page_posts + ( $paged - 2 ) * $per_page );\n }\n} );\n\nadd_filter( 'found_posts', function ( $found, $query ) use ( $wpide_first_page_posts ) {\n if ( is_admin() || ! $query->is_main_query() || ! $query->is_home() ) {\n return $found;\n }\n\n $per_page = max( 1, (int) get_option( 'posts_per_page' ) );\n $pages = 1 + (int) ceil( max( 0, $found - $wpide_first_page_posts ) / $per_page );\n\n if ( max( 1, (int) $query->get( 'paged' ) ) === 1 ) {\n return $pages * $wpide_first_page_posts;\n }\n\n return $found - $wpide_first_page_posts + $per_page;\n}, 10, 2 );",
"requires": [],
"notes": "Later pages use the \"Blog pages show at most\" setting. Sticky posts are added on top of the first-page count by WordPress."
},
{
"id": "ignore-sticky-posts-on-blog",
"version": 1,
"title": "Stop Sticky Posts Jumping to the Top",
"description": "Keeps sticky posts in normal date order on the blog page, so you can still mark posts as sticky for other uses without changing the main feed.",
"category": "archive",
"tags": [
"sticky",
"blog",
"order"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'pre_get_posts', function ( $query ) {\n if ( ! is_admin() && $query->is_main_query() && $query->is_home() ) {\n $query->set( 'ignore_sticky_posts', true );\n }\n} );",
"requires": [],
"notes": ""
},
{
"id": "sticky-posts-first-in-categories",
"version": 1,
"title": "Sticky Posts First in Category Archives",
"description": "Puts sticky posts at the top of the category archives they belong to, the same way WordPress already does on the blog page.",
"category": "archive",
"tags": [
"sticky",
"categories",
"archives"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_filter( 'the_posts', function ( $posts, $query ) {\n if ( is_admin() || ! $query->is_main_query() || ! $query->is_category() || $query->is_paged() ) {\n return $posts;\n }\n\n $sticky = array_map( 'absint', (array) get_option( 'sticky_posts', array() ) );\n\n if ( ! $sticky ) {\n return $posts;\n }\n\n $pinned = get_posts( array(\n 'post__in' => $sticky,\n 'category__in' => array( $query->get_queried_object_id() ),\n 'numberposts' => count( $sticky ),\n 'ignore_sticky_posts' => true,\n 'no_found_rows' => true,\n ) );\n\n if ( ! $pinned ) {\n return $posts;\n }\n\n $pinned_ids = wp_list_pluck( $pinned, 'ID' );\n $others = array_filter( $posts, function ( $post ) use ( $pinned_ids ) {\n return ! in_array( $post->ID, $pinned_ids, true );\n } );\n\n return array_merge( $pinned, array_values( $others ) );\n}, 10, 2 );",
"requires": [],
"notes": "Only the first page of each category archive is affected."
},
{
"id": "page-number-in-archive-titles",
"version": 1,
"title": "Page Number in Archive Headings",
"description": "Adds \"Page 2 of 7\" to archive headings on paginated pages, so visitors and search engines can tell the pages apart.",
"category": "archive",
"tags": [
"pagination",
"archives",
"titles"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_filter( 'get_the_archive_title', function ( $title ) {\n global $wp_query;\n\n $paged = (int) get_query_var( 'paged' );\n\n if ( $paged > 1 ) {\n $title .= sprintf( ' – Page %1$d of %2$d', $paged, max( $paged, (int) $wp_query->max_num_pages ) );\n }\n\n return $title;\n}, 30 );",
"requires": [],
"notes": ""
},
{
"id": "posts-per-page-author-date-archives",
"version": 1,
"title": "Posts per Page on Author and Date Archives",
"description": "Sets how many posts appear on author and date (year, month, day) archives, independent of the main blog setting.",
"category": "archive",
"tags": [
"pagination",
"authors",
"dates"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Posts per page on author archives and date archives.\n$wpide_author_per_page = 20;\n$wpide_date_per_page = 30;\n\nadd_action( 'pre_get_posts', function ( $query ) use ( $wpide_author_per_page, $wpide_date_per_page ) {\n if ( is_admin() || ! $query->is_main_query() ) {\n return;\n }\n\n if ( $query->is_author() ) {\n $query->set( 'posts_per_page', (int) $wpide_author_per_page );\n } elseif ( $query->is_date() ) {\n $query->set( 'posts_per_page', (int) $wpide_date_per_page );\n }\n} );",
"requires": [],
"notes": ""
},
{
"id": "query-loop-card-style-scss",
"version": 1,
"title": "Card Style for Query Loop Posts (SCSS)",
"description": "Turns each post in Query Loop blocks into a card with padding, rounded corners, a soft shadow and a lift on hover, for blog and archive templates in block themes.",
"category": "archive",
"tags": [
"scss",
"query-loop",
"cards"
],
"code_type": "scss",
"insert_method": "auto",
"location": "site_wide_header",
"insert_number": 1,
"code": "$card-padding: 1.25rem;\n$card-radius: 10px;\n$card-shadow: 0 2px 10px rgba(0, 0, 0, 0.08);\n$card-shadow-hover: 0 8px 22px rgba(0, 0, 0, 0.12);\n\n.wp-block-post-template {\n gap: 1.5rem;\n\n > .wp-block-post {\n padding: $card-padding;\n border-radius: $card-radius;\n background: var(--wp--preset--color--base, #fff);\n box-shadow: $card-shadow;\n transition: transform 0.2s ease, box-shadow 0.2s ease;\n\n &:hover,\n &:focus-within {\n transform: translateY(-3px);\n box-shadow: $card-shadow-hover;\n }\n\n .wp-block-post-featured-image {\n margin: (-$card-padding) (-$card-padding) 1rem;\n\n img {\n border-radius: $card-radius $card-radius 0 0;\n }\n }\n }\n}\n\n@media (prefers-reduced-motion: reduce) {\n .wp-block-post-template > .wp-block-post {\n transition: none;\n\n &:hover,\n &:focus-within {\n transform: none;\n }\n }\n}",
"requires": [],
"notes": "Change the variables at the top to match your design. Works with list and grid layouts."
},
{
"id": "newsletter-box-in-post-lists",
"version": 1,
"title": "Newsletter Box After the Third Post in Lists",
"description": "Inserts a newsletter sign-up box after the third post on the blog page, archives and search results, where browsing readers will see it.",
"category": "archive",
"tags": [
"newsletter",
"archives",
"cta"
],
"code_type": "html",
"insert_method": "auto",
"location": "archive_after_post",
"insert_number": 3,
"code": "
\n
Get new posts by email
\n
One short email when something new is published. Unsubscribe any time.
';\n} );",
"requires": [],
"notes": "Example: [rss_feed url=\"https://example.com/feed/\" items=\"5\" show_date=\"yes\" show_summary=\"no\"]. Feeds are cached for 12 hours by WordPress."
},
{
"id": "feed-read-more-link",
"version": 1,
"title": "\"Read the Full Article\" Link in Feeds",
"description": "Adds a link back to the post at the end of every feed item, so readers who see a summary in their reader or inbox can click through to your site.",
"category": "rss",
"tags": [
"rss",
"links",
"traffic"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Link text.\n$wpide_feed_link_text = 'Read the full article on our website';\n\n$wpide_feed_read_more = function ( $content ) use ( $wpide_feed_link_text ) {\n return $content . '
';\n};\n\nadd_filter( 'the_excerpt_rss', $wpide_feed_read_more, 20 );\nadd_filter( 'the_content_feed', $wpide_feed_read_more, 20 );",
"requires": [],
"notes": "Change the link text at the top."
},
{
"id": "utm-tags-on-feed-links",
"version": 1,
"title": "Campaign Tags on Feed Item Links",
"description": "Adds utm_source, utm_medium and utm_campaign parameters to the links in your RSS feed, so visits from feed readers and RSS emails show up clearly in your analytics.",
"category": "rss",
"tags": [
"rss",
"utm",
"analytics"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Campaign parameters added to feed links.\n$wpide_feed_utm = array(\n 'utm_source' => 'rss',\n 'utm_medium' => 'feed',\n 'utm_campaign' => 'rss-feed',\n);\n\nadd_filter( 'the_permalink_rss', function ( $link ) use ( $wpide_feed_utm ) {\n return add_query_arg( array_map( 'rawurlencode', $wpide_feed_utm ), $link );\n} );",
"requires": [],
"notes": "Change the parameter values to match your analytics naming."
},
{
"id": "custom-feed-title",
"version": 1,
"title": "Custom Title for Your RSS Feeds",
"description": "Sets the title feed readers and podcast apps show for your feeds, for example \"Acme Blog\" instead of the full site name and archive name.",
"category": "rss",
"tags": [
"rss",
"title",
"branding"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Title shown in feed readers.\n$wpide_feed_title = 'Acme Blog';\n\nadd_filter( 'get_wp_title_rss', function ( $title ) use ( $wpide_feed_title ) {\n return '' !== trim( $wpide_feed_title ) ? $wpide_feed_title : $title;\n} );",
"requires": [],
"notes": ""
},
{
"id": "feed-logo-image",
"version": 1,
"title": "Use Your Logo as the Feed Image",
"description": "Shows your own logo in feed readers instead of the site icon, which is often too small or too simple for that space.",
"category": "rss",
"tags": [
"rss",
"logo",
"branding"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Full URL of the logo for feeds (empty = custom logo from the theme).\n$wpide_feed_logo = '';\n\nadd_action( 'init', function () {\n remove_action( 'rss2_head', 'rss2_site_icon' );\n} );\n\nadd_action( 'rss2_head', function () use ( $wpide_feed_logo ) {\n $url = $wpide_feed_logo;\n\n if ( '' === $url && has_custom_logo() ) {\n $url = (string) wp_get_attachment_image_url( (int) get_theme_mod( 'custom_logo' ), 'medium' );\n }\n\n if ( '' === $url ) {\n return;\n }\n\n echo \"\\n\";\n echo \"\\t\" . esc_url( $url ) . \"\\n\";\n echo \"\\t\" . esc_html( get_bloginfo_rss( 'name' ) ) . \"\\n\";\n echo \"\\t\" . esc_url( home_url( '/' ) ) . \"\\n\";\n echo \"\\n\";\n} );",
"requires": [],
"notes": "Put the full URL of a square image of at least 144 pixels in $wpide_feed_logo, or leave it empty to use the theme's custom logo."
},
{
"id": "exclude-protected-posts-from-feeds",
"version": 1,
"title": "Keep Password-Protected Posts Out of Feeds",
"description": "Removes password-protected posts from all feeds, where they otherwise appear with a \"There is no excerpt because this is a protected post\" message.",
"category": "rss",
"tags": [
"rss",
"password",
"privacy"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'pre_get_posts', function ( $query ) {\n if ( ! is_admin() && $query->is_main_query() && $query->is_feed() ) {\n $query->set( 'has_password', false );\n }\n} );",
"requires": [],
"notes": ""
},
{
"id": "strip-images-from-feed",
"version": 1,
"title": "Remove Images From Feed Content",
"description": "Strips images and image captions from the content sent in your feeds, keeping feeds light for readers and services that only want the text.",
"category": "rss",
"tags": [
"rss",
"images",
"text"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "$wpide_strip_feed_images = function ( $content ) {\n $content = preg_replace( '/]*>\\s*(?:]*>)?\\s*]*>\\s*(?:<\\/a>)?\\s*(?:)?\\s*<\\/figure>/is', '', $content );\n $content = preg_replace( '/]*>/i', '', (string) $content );\n\n return (string) $content;\n};\n\nadd_filter( 'the_content_feed', $wpide_strip_feed_images, 30 );\nadd_filter( 'the_excerpt_rss', $wpide_strip_feed_images, 30 );",
"requires": [],
"notes": "The featured image added by other feed snippets is not affected."
},
{
"id": "noindex-feeds",
"version": 1,
"title": "Keep Feeds Out of Search Results",
"description": "Sends an X-Robots-Tag header that asks search engines not to index your RSS feeds, so feed URLs do not compete with your real pages.",
"category": "rss",
"tags": [
"rss",
"noindex",
"seo"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'template_redirect', function () {\n if ( is_feed() && ! headers_sent() ) {\n header( 'X-Robots-Tag: noindex, follow', true );\n }\n}, 1 );",
"requires": [],
"notes": "Feed readers ignore this header, so subscribers are not affected."
},
{
"id": "order-feeds-by-last-modified",
"version": 1,
"title": "Order Feeds by Last Updated Date",
"description": "Lists feed items by the date they were last updated instead of the publish date, so readers see refreshed articles again.",
"category": "rss",
"tags": [
"rss",
"order",
"modified-date"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'pre_get_posts', function ( $query ) {\n if ( ! is_admin() && $query->is_main_query() && $query->is_feed() && ! $query->is_comment_feed() ) {\n $query->set( 'orderby', 'modified' );\n $query->set( 'order', 'DESC' );\n }\n} );",
"requires": [],
"notes": "Some readers show an updated post as a new item. Use it if you regularly refresh older content."
},
{
"id": "limit-feed-to-recent-days",
"version": 1,
"title": "Only Include Recent Posts in Feeds",
"description": "Limits your feeds to posts published in the last few days, which keeps them short for busy news sites and stops readers re-importing old items.",
"category": "rss",
"tags": [
"rss",
"dates",
"limit"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Only posts from the last this many days appear in feeds.\n$wpide_feed_days = 30;\n\nadd_action( 'pre_get_posts', function ( $query ) use ( $wpide_feed_days ) {\n if ( is_admin() || ! $query->is_main_query() || ! $query->is_feed() || $query->is_comment_feed() ) {\n return;\n }\n\n $query->set( 'date_query', array(\n array(\n 'after' => absint( $wpide_feed_days ) . ' days ago',\n 'inclusive' => true,\n ),\n ) );\n} );",
"requires": [],
"notes": "Change the number of days at the top. A feed can be empty if nothing was published in that time."
},
{
"id": "absolute-urls-in-feeds",
"version": 1,
"title": "Fix Relative Links and Images in Feeds",
"description": "Turns relative links and image paths such as \"/about/\" in feed content into full URLs, so they work in feed readers and RSS emails.",
"category": "rss",
"tags": [
"rss",
"urls",
"images"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "$wpide_absolute_feed_urls = function ( $content ) {\n $base = untrailingslashit( home_url() );\n\n $result = preg_replace_callback( '/\\s(href|src)=([\"\\'])(\\/(?!\\/)[^\"\\']*)\\2/i', function ( $m ) use ( $base ) {\n return ' ' . $m[1] . '=' . $m[2] . esc_url( $base . $m[3] ) . $m[2];\n }, $content );\n\n return null === $result ? $content : $result;\n};\n\nadd_filter( 'the_content_feed', $wpide_absolute_feed_urls, 40 );\nadd_filter( 'the_excerpt_rss', $wpide_absolute_feed_urls, 40 );",
"requires": [],
"notes": ""
},
{
"id": "remove-extra-feed-links",
"version": 1,
"title": "Remove Category, Tag and Author Feed Links From the Head",
"description": "Stops WordPress from advertising separate feeds for every category, tag, author, search and archive page, while keeping your main feed link.",
"category": "rss",
"tags": [
"rss",
"head",
"cleanup"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "foreach ( array( 'category', 'tag', 'tax', 'author', 'search', 'post_type_archive' ) as $wpide_feed_type ) {\n add_filter( 'feed_links_extra_show_' . $wpide_feed_type . '_feed', '__return_false' );\n}",
"requires": [],
"notes": "The feeds still work if someone visits them directly. Use the Remove Comment Feeds snippet for comment feed links."
},
{
"id": "feed-only-content-shortcodes",
"version": 1,
"title": "Feed-Only and Hide-in-Feed Shortcodes",
"description": "Adds [feed_only] and [hide_in_feed] shortcodes, so you can show a special message to RSS subscribers or keep interactive parts of a post out of feeds.",
"category": "rss",
"tags": [
"rss",
"shortcode",
"content"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_shortcode( 'feed_only', function ( $atts, $content = '' ) {\n return is_feed() ? do_shortcode( (string) $content ) : '';\n} );\n\nadd_shortcode( 'hide_in_feed', function ( $atts, $content = '' ) {\n return is_feed() ? '' : do_shortcode( (string) $content );\n} );",
"requires": [],
"notes": "Example: [hide_in_feed]Interactive calculator here[/hide_in_feed][feed_only]Visit the post to use the calculator.[/feed_only]"
},
{
"id": "rss-subscribe-box-after-posts",
"version": 1,
"title": "RSS Subscribe Box After Posts",
"description": "Adds a small box at the end of each blog post inviting readers to follow the site by RSS, with a link to your feed.",
"category": "rss",
"tags": [
"rss",
"subscribe",
"posts"
],
"code_type": "universal",
"insert_method": "auto",
"location": "after_content",
"insert_number": 1,
"code": "\n
';\n } );\n} );",
"requires": [],
"notes": "Searches by logged-in editors are not counted. The log keeps the 300 most recent distinct terms in one option."
},
{
"id": "search-results-count-heading",
"version": 1,
"title": "Show the Number of Search Results",
"description": "Prints a line such as 12 results for \"pricing\" above the search results, so visitors know how much was found.",
"category": "search",
"tags": [
"search",
"results",
"count"
],
"code_type": "php",
"insert_method": "auto",
"location": "frontend_only",
"insert_number": 1,
"code": "add_action( 'loop_start', function ( $query ) {\n static $done = false;\n\n if ( $done || ! $query->is_main_query() || ! $query->is_search() ) {\n return;\n }\n\n $done = true;\n $count = (int) $query->found_posts;\n $label = 1 === $count ? '%1$s result for \"%2$s\"' : '%1$s results for \"%2$s\"';\n\n echo '
' . $content;\n}, 5 );",
"requires": [],
"notes": "Add widgets under Appearance > Widgets. Nothing is printed while the area is empty."
},
{
"id": "header-widget-area",
"version": 1,
"title": "Widget Area at the Top of Every Page",
"description": "Adds a \"Top Bar\" widget area that prints right after the opening body tag, handy for a contact line, social links or a short promo across the whole site.",
"category": "widgets",
"tags": [
"widgets",
"header",
"top-bar"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'widgets_init', function () {\n register_sidebar( array(\n 'name' => 'Top Bar',\n 'id' => 'wpide-top-bar',\n 'description' => 'Shown at the very top of every page.',\n 'before_widget' => '
';\n} );",
"requires": [],
"notes": "Your theme must call wp_body_open(), which all modern themes do."
},
{
"id": "widget-visibility-logged-in-out",
"version": 1,
"title": "Show Widgets Only to Logged-In or Logged-Out Visitors",
"description": "Adds a \"Show to\" setting to every classic widget so you can display it to everyone, only to logged-in users, or only to visitors who are not logged in.",
"category": "widgets",
"tags": [
"widgets",
"visibility",
"members"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'in_widget_form', function ( $widget, $return, $instance ) {\n $value = isset( $instance['wpide_visibility'] ) ? $instance['wpide_visibility'] : '';\n $options = array(\n '' => 'Everyone',\n 'logged_in' => 'Logged-in users',\n 'logged_out' => 'Logged-out visitors',\n );\n\n echo '
';\n echo '
';\n}, 10, 3 );\n\nadd_filter( 'widget_update_callback', function ( $instance, $new_instance ) {\n $value = isset( $new_instance['wpide_visibility'] ) ? sanitize_key( $new_instance['wpide_visibility'] ) : '';\n\n $instance['wpide_visibility'] = in_array( $value, array( 'logged_in', 'logged_out' ), true ) ? $value : '';\n\n return $instance;\n}, 10, 2 );\n\nadd_filter( 'widget_display_callback', function ( $instance ) {\n if ( ! is_array( $instance ) || empty( $instance['wpide_visibility'] ) ) {\n return $instance;\n }\n\n if ( 'logged_in' === $instance['wpide_visibility'] && ! is_user_logged_in() ) {\n return false;\n }\n\n if ( 'logged_out' === $instance['wpide_visibility'] && is_user_logged_in() ) {\n return false;\n }\n\n return $instance;\n} );",
"requires": [],
"notes": "Works with classic widgets and the Legacy Widget block. Block widgets do not have the setting."
},
{
"id": "hide-sidebar-on-selected-pages",
"version": 1,
"title": "Hide a Sidebar on Selected Pages or Post Types",
"description": "Empties a widget area on the pages or post types you choose, for example to keep the sidebar off landing pages and checkout pages.",
"category": "widgets",
"tags": [
"widgets",
"sidebar",
"layout"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// ID of the widget area to hide.\n$wpide_hidden_sidebar = 'sidebar-1';\n// Page or post IDs where it is hidden.\n$wpide_hide_sidebar_ids = array( 0 );\n// Post types whose single views hide it, for example array( 'page' ).\n$wpide_hide_sidebar_types = array();\n\nadd_filter( 'sidebars_widgets', function ( $sidebars ) use ( $wpide_hidden_sidebar, $wpide_hide_sidebar_ids, $wpide_hide_sidebar_types ) {\n if ( is_admin() || ! isset( $sidebars[ $wpide_hidden_sidebar ] ) || ! did_action( 'wp' ) ) {\n return $sidebars;\n }\n\n $hide = is_singular() && in_array( get_queried_object_id(), array_map( 'absint', $wpide_hide_sidebar_ids ), true );\n\n if ( ! $hide && $wpide_hide_sidebar_types && is_singular( $wpide_hide_sidebar_types ) ) {\n $hide = true;\n }\n\n if ( $hide ) {\n $sidebars[ $wpide_hidden_sidebar ] = array();\n }\n\n return $sidebars;\n} );",
"requires": [],
"notes": "Set the sidebar ID (shown in Appearance > Widgets or your theme's code). Some themes still reserve the column; switch those pages to a full-width template if so."
},
{
"id": "recent-posts-widget-exclude-category",
"version": 1,
"title": "Exclude a Category From the Recent Posts Widget",
"description": "Keeps posts from the categories you choose out of the classic Recent Posts widget, for example sponsored posts or internal news.",
"category": "widgets",
"tags": [
"widgets",
"recent-posts",
"categories"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Category IDs to leave out of the widget.\n$wpide_widget_excluded_categories = array( 0 );\n\nadd_filter( 'widget_posts_args', function ( $args ) use ( $wpide_widget_excluded_categories ) {\n $args['category__not_in'] = array_map( 'absint', $wpide_widget_excluded_categories );\n\n return $args;\n} );",
"requires": [],
"notes": "Use category IDs. The Latest Posts block has its own category setting."
},
{
"id": "recent-comments-widget-hide-staff",
"version": 1,
"title": "Hide Staff Replies in the Recent Comments Widget",
"description": "Leaves comments written by authors, editors and administrators out of the Recent Comments widget, so it highlights what readers are saying.",
"category": "widgets",
"tags": [
"widgets",
"comments",
"community"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_filter( 'widget_comments_args', function ( $args ) {\n $staff = get_users( array(\n 'capability' => 'edit_posts',\n 'fields' => 'ID',\n 'number' => 200,\n ) );\n\n if ( $staff ) {\n $args['author__not_in'] = array_map( 'intval', $staff );\n }\n\n return $args;\n} );",
"requires": [],
"notes": ""
},
{
"id": "archives-widget-options",
"version": 1,
"title": "Archives Widget: Yearly Links and a Limit",
"description": "Changes the classic Archives widget to list years instead of months and caps how many entries it shows, keeping the sidebar short on old blogs.",
"category": "widgets",
"tags": [
"widgets",
"archives",
"sidebar"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// yearly, monthly or weekly.\n$wpide_archives_widget_type = 'yearly';\n// Maximum number of links (0 = all).\n$wpide_archives_widget_limit = 10;\n\n$wpide_archives_widget_args = function ( $args ) use ( $wpide_archives_widget_type, $wpide_archives_widget_limit ) {\n $args['type'] = $wpide_archives_widget_type;\n\n if ( $wpide_archives_widget_limit > 0 ) {\n $args['limit'] = (int) $wpide_archives_widget_limit;\n }\n\n return $args;\n};\n\nadd_filter( 'widget_archives_args', $wpide_archives_widget_args );\nadd_filter( 'widget_archives_dropdown_args', $wpide_archives_widget_args );",
"requires": [],
"notes": "Set the type to monthly to keep months and only apply the limit."
},
{
"id": "tag-cloud-widget-popular-only",
"version": 1,
"title": "Tag Cloud Widget: Most Popular Tags Only",
"description": "Limits the Tag Cloud widget and block to your most used tags and orders them by popularity, so the cloud stays readable on sites with hundreds of tags.",
"category": "widgets",
"tags": [
"widgets",
"tags",
"tag-cloud"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Number of tags to show.\n$wpide_tag_cloud_number = 20;\n\nadd_filter( 'widget_tag_cloud_args', function ( $args ) use ( $wpide_tag_cloud_number ) {\n $args['number'] = absint( $wpide_tag_cloud_number );\n $args['orderby'] = 'count';\n $args['order'] = 'DESC';\n\n return $args;\n} );",
"requires": [],
"notes": ""
},
{
"id": "pages-widget-options",
"version": 1,
"title": "Pages Widget: Exclude Pages and Sort by Menu Order",
"description": "Hides pages such as Privacy Policy or Thank You from the Pages widget and sorts the rest by their menu order.",
"category": "widgets",
"tags": [
"widgets",
"pages",
"navigation"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Page IDs to hide from the Pages widget.\n$wpide_pages_widget_exclude = array( 0 );\n\nadd_filter( 'widget_pages_args', function ( $args ) use ( $wpide_pages_widget_exclude ) {\n $existing = isset( $args['exclude'] ) ? wp_parse_id_list( $args['exclude'] ) : array();\n\n $args['exclude'] = implode( ',', array_merge( $existing, array_map( 'absint', $wpide_pages_widget_exclude ) ) );\n $args['sort_column'] = 'menu_order, post_title';\n\n return $args;\n} );",
"requires": [],
"notes": "Use page IDs."
},
{
"id": "widget-css-class-field",
"version": 1,
"title": "Custom CSS Classes for Widgets",
"description": "Adds a \"CSS classes\" field to every classic widget, so you can style individual widgets from your theme or a CSS snippet.",
"category": "widgets",
"tags": [
"widgets",
"css",
"classes"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'in_widget_form', function ( $widget, $return, $instance ) {\n $value = isset( $instance['wpide_css_class'] ) ? $instance['wpide_css_class'] : '';\n\n echo '
';\n\n foreach ( $this->fields as $key => $label ) {\n $id = $this->get_field_id( $key );\n $name = $this->get_field_name( $key );\n\n if ( in_array( $key, array( 'address', 'hours' ), true ) ) {\n echo '';\n } else {\n echo '';\n }\n }\n\n return '';\n }\n\n public function update( $new_instance, $old_instance ) {\n return array(\n 'title' => sanitize_text_field( isset( $new_instance['title'] ) ? $new_instance['title'] : '' ),\n 'address' => sanitize_textarea_field( isset( $new_instance['address'] ) ? $new_instance['address'] : '' ),\n 'phone' => sanitize_text_field( isset( $new_instance['phone'] ) ? $new_instance['phone'] : '' ),\n 'email' => sanitize_email( isset( $new_instance['email'] ) ? $new_instance['email'] : '' ),\n 'hours' => sanitize_textarea_field( isset( $new_instance['hours'] ) ? $new_instance['hours'] : '' ),\n );\n }\n }\n}\n\nadd_action( 'widgets_init', function () {\n register_widget( 'WPIDE_Contact_Details_Widget' );\n} );",
"requires": [],
"notes": "Add it under Appearance > Widgets (as a Legacy Widget in the block widget editor)."
},
{
"id": "hide-widget-titles-with-exclamation",
"version": 1,
"title": "Hide Widget Titles That Start With \"!\"",
"description": "Lets you keep a descriptive widget title in the admin but hide it on the site, just by starting the title with an exclamation mark.",
"category": "widgets",
"tags": [
"widgets",
"titles",
"sidebar"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_filter( 'widget_title', function ( $title ) {\n return ( is_string( $title ) && 0 === strpos( $title, '!' ) ) ? '' : $title;\n} );",
"requires": [],
"notes": "Example: a widget titled \"!Newsletter form\" shows no heading on the site."
},
{
"id": "sticky-last-sidebar-widget",
"version": 1,
"title": "Keep the Last Sidebar Widget in View",
"description": "Makes the last widget in the sidebar stick to the top of the screen while the visitor scrolls long posts, a good spot for a newsletter form or ad.",
"category": "widgets",
"tags": [
"widgets",
"sticky",
"sidebar"
],
"code_type": "css",
"insert_method": "auto",
"location": "site_wide_header",
"insert_number": 1,
"code": "@media (min-width: 1024px) {\n #secondary .widget:last-child,\n .widget-area .widget:last-child,\n .sidebar .widget:last-child {\n position: sticky;\n top: 2rem;\n }\n\n .admin-bar #secondary .widget:last-child,\n .admin-bar .widget-area .widget:last-child,\n .admin-bar .sidebar .widget:last-child {\n top: calc(2rem + 32px);\n }\n}",
"requires": [],
"notes": "Only applies on screens wider than 1024 pixels. Adjust the selectors if your theme uses different sidebar classes."
},
{
"id": "widget-area-shortcode",
"version": 1,
"title": "Widget Area Shortcode",
"description": "Adds a [widget_area] shortcode that prints any widget area inside a page, post or block template, so the same widgets can be reused anywhere.",
"category": "widgets",
"tags": [
"widgets",
"shortcode",
"sidebar"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_shortcode( 'widget_area', function ( $atts ) {\n static $depth = 0;\n\n $atts = shortcode_atts( array( 'id' => '' ), $atts, 'widget_area' );\n $id = sanitize_text_field( $atts['id'] );\n\n if ( '' === $id || $depth > 0 || ! is_active_sidebar( $id ) ) {\n return '';\n }\n\n $depth++;\n ob_start();\n dynamic_sidebar( $id );\n $html = ob_get_clean();\n $depth--;\n\n return '
' . $html . '
';\n} );",
"requires": [],
"notes": "Example: [widget_area id=\"sidebar-1\"]. Find the IDs of your widget areas in your theme or with the Register Extra Widget Areas snippet."
},
{
"id": "register-extra-widget-areas",
"version": 1,
"title": "Register Extra Widget Areas",
"description": "Creates additional widget areas, such as a shop sidebar or a blog sidebar, that you can fill under Appearance > Widgets and place with a shortcode or theme hook.",
"category": "widgets",
"tags": [
"widgets",
"sidebar",
"register"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Widget area ID => name.\n$wpide_extra_widget_areas = array(\n 'wpide-blog-sidebar' => 'Blog Sidebar',\n 'wpide-shop-sidebar' => 'Shop Sidebar',\n);\n\nadd_action( 'widgets_init', function () use ( $wpide_extra_widget_areas ) {\n foreach ( $wpide_extra_widget_areas as $id => $name ) {\n register_sidebar( array(\n 'id' => $id,\n 'name' => $name,\n 'description' => sprintf( 'Show it with [widget_area id=\"%s\"].', $id ),\n 'before_widget' => '',\n 'after_widget' => '',\n 'before_title' => '
',\n 'after_title' => '
',\n ) );\n }\n} );",
"requires": [],
"notes": "Add or rename areas in the list. Show them with [widget_area id=\"...\"] from the Widget Area Shortcode snippet."
},
{
"id": "limit-blocks-in-widget-editor",
"version": 1,
"title": "Limit the Blocks Available in the Widget Editor",
"description": "Restricts the block widget editor and the Customizer to a short list of blocks that make sense in sidebars, keeping widget areas tidy for clients.",
"category": "widgets",
"tags": [
"widgets",
"blocks",
"editor"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Blocks allowed in widget areas.\n$wpide_widget_blocks = array(\n 'core/paragraph',\n 'core/heading',\n 'core/image',\n 'core/list',\n 'core/list-item',\n 'core/buttons',\n 'core/button',\n 'core/search',\n 'core/latest-posts',\n 'core/categories',\n 'core/archives',\n 'core/tag-cloud',\n 'core/social-links',\n 'core/social-link',\n 'core/shortcode',\n 'core/legacy-widget',\n 'core/widget-group',\n);\n\nadd_filter( 'allowed_block_types_all', function ( $allowed, $context ) use ( $wpide_widget_blocks ) {\n if ( isset( $context->name ) && in_array( $context->name, array( 'core/edit-widgets', 'core/customize-widgets' ), true ) ) {\n return $wpide_widget_blocks;\n }\n\n return $allowed;\n}, 10, 2 );",
"requires": [],
"notes": "Edit the list to allow more blocks. Blocks already placed in widget areas keep working."
},
{
"id": "recent-posts-widget-current-category",
"version": 1,
"title": "Recent Posts Widget Follows the Current Category",
"description": "Makes the classic Recent Posts widget list posts from the same category as the post being read, turning it into a simple related posts list.",
"category": "widgets",
"tags": [
"widgets",
"recent-posts",
"related"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_filter( 'widget_posts_args', function ( $args ) {\n if ( ! is_singular( 'post' ) ) {\n return $args;\n }\n\n $categories = wp_get_post_categories( get_queried_object_id() );\n\n if ( $categories ) {\n $args['category__in'] = $categories;\n }\n\n $args['post__not_in'] = array( get_queried_object_id() );\n\n return $args;\n} );",
"requires": [],
"notes": "On pages other than single posts the widget shows the latest posts as usual."
},
{
"id": "woo-shop-filters-widget-area",
"version": 1,
"title": "Filters Widget Area Above the Shop",
"description": "Registers a \"Shop Filters\" widget area and shows it above the product grid on shop and category pages, a natural home for price, attribute and rating filters.",
"category": "widgets",
"tags": [
"woocommerce",
"widgets",
"filters"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'widgets_init', function () {\n register_sidebar( array(\n 'name' => 'Shop Filters',\n 'id' => 'wpide-shop-filters',\n 'description' => 'Shown above the products on shop and product category pages.',\n 'before_widget' => '
',\n 'after_widget' => '
',\n 'before_title' => '
',\n 'after_title' => '
',\n ) );\n} );\n\nadd_action( 'woocommerce_before_shop_loop', function () {\n if ( ! is_active_sidebar( 'wpide-shop-filters' ) ) {\n return;\n }\n\n echo '
\n',\n ) );\n} );",
"requires": [],
"notes": "Design the layout in the editor, copy it with \"Copy\" from the block toolbar and paste the markup into the content setting."
},
{
"id": "custom-block-styles",
"version": 1,
"title": "Extra Block Styles: Card, Pill Button, Shadow Image and Checklist",
"description": "Adds four ready-made style options to the block editor: a card style for Group blocks, a pill style for buttons, a soft shadow for images and a checkmark style for lists.",
"category": "gutenberg",
"tags": [
"block-styles",
"design",
"editor"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'init', function () {\n register_block_style( 'core/group', array(\n 'name' => 'wpide-card',\n 'label' => 'Card',\n 'inline_style' => '.wp-block-group.is-style-wpide-card{padding:1.5em;border-radius:10px;background:#fff;color:#1d2327;box-shadow:0 2px 12px rgba(0,0,0,.08);}',\n ) );\n\n register_block_style( 'core/button', array(\n 'name' => 'wpide-pill',\n 'label' => 'Pill',\n 'inline_style' => '.wp-block-button.is-style-wpide-pill .wp-block-button__link{border-radius:999px;padding-left:1.75em;padding-right:1.75em;}',\n ) );\n\n register_block_style( 'core/image', array(\n 'name' => 'wpide-shadow',\n 'label' => 'Soft shadow',\n 'inline_style' => '.wp-block-image.is-style-wpide-shadow img{border-radius:6px;box-shadow:0 10px 30px rgba(0,0,0,.18);}',\n ) );\n\n register_block_style( 'core/list', array(\n 'name' => 'wpide-checklist',\n 'label' => 'Checklist',\n 'inline_style' => '.wp-block-list.is-style-wpide-checklist{list-style:none;padding-left:0;}.wp-block-list.is-style-wpide-checklist li::before{content:\"\\2713\";margin-right:.6em;color:#00a32a;font-weight:700;}',\n ) );\n} );",
"requires": [],
"notes": "Pick the styles in the block sidebar under Styles. Edit the CSS in each inline_style to match your design."
},
{
"id": "remove-core-block-styles",
"version": 1,
"title": "Remove Built-In Block Style Options",
"description": "Removes block style choices you do not want editors to use, such as the outline button, rounded image or dotted separator, keeping the design consistent.",
"category": "gutenberg",
"tags": [
"block-styles",
"editor",
"design"
],
"code_type": "php",
"insert_method": "auto",
"location": "admin_only",
"insert_number": 1,
"code": "// Block name => style names to remove.\n$wpide_removed_block_styles = array(\n 'core/button' => array( 'outline' ),\n 'core/image' => array( 'rounded' ),\n 'core/separator' => array( 'dots', 'wide' ),\n 'core/quote' => array( 'plain' ),\n);\n\nadd_action( 'enqueue_block_editor_assets', function () use ( $wpide_removed_block_styles ) {\n wp_add_inline_script(\n 'wp-blocks',\n 'wp.domReady(function(){(window._wpLoadBlockEditor||Promise.resolve()).then(function(){var map=' . wp_json_encode( $wpide_removed_block_styles ) . ';Object.keys(map).forEach(function(block){map[block].forEach(function(style){wp.blocks.unregisterBlockStyle(block,style);});});});});'\n );\n} );",
"requires": [],
"notes": "Edit the list of block names and style names. Content that already uses a removed style keeps its look."
},
{
"id": "limit-embed-providers",
"version": 1,
"title": "Limit the Embed Providers in the Inserter",
"description": "Hides the long list of embed blocks (TikTok, Reddit, Kickstarter and dozens more) from the inserter, keeping only the providers you actually use.",
"category": "gutenberg",
"tags": [
"embeds",
"inserter",
"editor"
],
"code_type": "php",
"insert_method": "auto",
"location": "admin_only",
"insert_number": 1,
"code": "// Embed providers to keep in the inserter.\n$wpide_kept_embeds = array( 'youtube', 'vimeo', 'twitter', 'spotify' );\n\nadd_action( 'enqueue_block_editor_assets', function () use ( $wpide_kept_embeds ) {\n wp_add_inline_script(\n 'wp-blocks',\n 'wp.domReady(function(){(window._wpLoadBlockEditor||Promise.resolve()).then(function(){var keep=' . wp_json_encode( array_values( $wpide_kept_embeds ) ) . ';(wp.blocks.getBlockVariations(\"core/embed\")||[]).forEach(function(variation){if(keep.indexOf(variation.name)===-1){wp.blocks.unregisterBlockVariation(\"core/embed\",variation.name);}});});});'\n );\n} );",
"requires": [],
"notes": "Pasting a URL from a hidden provider still embeds it. Provider names are lowercase, such as youtube, vimeo, twitter, spotify or soundcloud."
},
{
"id": "lock-editor-to-theme-presets",
"version": 1,
"title": "Lock Colors and Sizes to the Theme Presets",
"description": "Removes the custom color picker, custom gradients and free-form font and spacing sizes from the editor, so editors can only choose from your theme's palette and scales.",
"category": "gutenberg",
"tags": [
"colors",
"typography",
"design-system"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_filter( 'wp_theme_json_data_theme', function ( $theme_json ) {\n return $theme_json->update_with( array(\n 'version' => 3,\n 'settings' => array(\n 'color' => array(\n 'custom' => false,\n 'customGradient' => false,\n 'customDuotone' => false,\n ),\n 'typography' => array(\n 'customFontSize' => false,\n ),\n 'spacing' => array(\n 'customSpacingSize' => false,\n ),\n ),\n ) );\n} );",
"requires": [],
"notes": "Existing content with custom values keeps them. Works with block and classic themes."
},
{
"id": "add-brand-colors-to-palette",
"version": 1,
"title": "Add Brand Colors to the Editor Palette",
"description": "Adds your brand colors to the color palette in the block editor, next to the theme's colors, so the exact shades are one click away.",
"category": "gutenberg",
"tags": [
"colors",
"palette",
"branding"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Colors to add: slug, name and hex value.\n$wpide_brand_colors = array(\n array( 'slug' => 'brand', 'name' => 'Brand', 'color' => '#2271b1' ),\n array( 'slug' => 'brand-dark', 'name' => 'Brand dark', 'color' => '#135e96' ),\n array( 'slug' => 'accent', 'name' => 'Accent', 'color' => '#d63638' ),\n);\n\nadd_filter( 'wp_theme_json_data_theme', function ( $theme_json ) use ( $wpide_brand_colors ) {\n $data = $theme_json->get_data();\n $palette = isset( $data['settings']['color']['palette'] ) && is_array( $data['settings']['color']['palette'] ) ? $data['settings']['color']['palette'] : array();\n $palette = isset( $palette['theme'] ) && is_array( $palette['theme'] ) ? $palette['theme'] : $palette;\n $by_slug = array();\n\n foreach ( array_merge( $palette, $wpide_brand_colors ) as $color ) {\n if ( isset( $color['slug'], $color['color'] ) ) {\n $by_slug[ $color['slug'] ] = $color;\n }\n }\n\n return $theme_json->update_with( array(\n 'version' => 3,\n 'settings' => array(\n 'color' => array(\n 'palette' => array_values( $by_slug ),\n ),\n ),\n ) );\n} );",
"requires": [],
"notes": "Colors with a slug the theme already uses replace the theme color. Each color also becomes a CSS variable such as --wp--preset--color--brand."
},
{
"id": "add-custom-font-sizes",
"version": 1,
"title": "Add Custom Font Sizes to the Editor",
"description": "Adds your own named font sizes, such as \"Lead\" or \"Display\", to the font size picker in the block editor alongside the theme's sizes.",
"category": "gutenberg",
"tags": [
"typography",
"font-sizes",
"editor"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Font sizes to add: slug, name and CSS size.\n$wpide_font_sizes = array(\n array( 'slug' => 'lead', 'name' => 'Lead', 'size' => '1.25rem' ),\n array( 'slug' => 'display', 'name' => 'Display', 'size' => 'clamp(2.5rem, 5vw, 4rem)' ),\n);\n\nadd_filter( 'wp_theme_json_data_theme', function ( $theme_json ) use ( $wpide_font_sizes ) {\n $data = $theme_json->get_data();\n $sizes = isset( $data['settings']['typography']['fontSizes'] ) && is_array( $data['settings']['typography']['fontSizes'] ) ? $data['settings']['typography']['fontSizes'] : array();\n $sizes = isset( $sizes['theme'] ) && is_array( $sizes['theme'] ) ? $sizes['theme'] : $sizes;\n $by_slug = array();\n\n foreach ( array_merge( $sizes, $wpide_font_sizes ) as $size ) {\n if ( isset( $size['slug'], $size['size'] ) ) {\n $by_slug[ $size['slug'] ] = $size;\n }\n }\n\n return $theme_json->update_with( array(\n 'version' => 3,\n 'settings' => array(\n 'typography' => array(\n 'fontSizes' => array_values( $by_slug ),\n ),\n ),\n ) );\n} );",
"requires": [],
"notes": "Sizes accept any CSS length, including clamp() for fluid type. A slug the theme already uses replaces the theme size."
},
{
"id": "wider-editor-content",
"version": 1,
"title": "Wider Content Area in the Editor",
"description": "Makes the writing area of the block editor wider, giving more room on large screens without changing how the site looks to visitors.",
"category": "gutenberg",
"tags": [
"editor",
"width",
"layout"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Width of the content column in the editor.\n$wpide_editor_content_width = '1000px';\n\nadd_action( 'enqueue_block_assets', function () use ( $wpide_editor_content_width ) {\n if ( ! is_admin() || ! preg_match( '/^\\d+(\\.\\d+)?(px|rem|em|vw|%)$/', $wpide_editor_content_width ) ) {\n return;\n }\n\n wp_register_style( 'wpide-editor-width', false, array(), '1.0' );\n wp_enqueue_style( 'wpide-editor-width' );\n wp_add_inline_style( 'wpide-editor-width', '.editor-styles-wrapper{--wp--style--global--content-size:' . $wpide_editor_content_width . ';}.editor-styles-wrapper .is-root-container > .wp-block:not([data-align=\"wide\"]):not([data-align=\"full\"]){max-width:' . $wpide_editor_content_width . ';}' );\n} );",
"requires": [],
"notes": "Set any CSS width such as 1000px or 75rem."
},
{
"id": "block-template-for-new-posts",
"version": 1,
"title": "Block Template for New Posts",
"description": "Starts every new post with a set of placeholder blocks, such as a summary paragraph, a heading and an image, so writers follow the same structure.",
"category": "gutenberg",
"tags": [
"templates",
"blocks",
"editor"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Post type that gets the template.\n$wpide_template_post_type = 'post';\n// Blocks and their attributes.\n$wpide_template_blocks = array(\n array( 'core/paragraph', array( 'placeholder' => 'Summarize the post in one or two sentences...' ) ),\n array( 'core/heading', array( 'level' => 2, 'placeholder' => 'First section heading' ) ),\n array( 'core/paragraph', array( 'placeholder' => 'Write the first section...' ) ),\n array( 'core/image', array() ),\n);\n// false, 'insert' or 'all'.\n$wpide_template_lock = false;\n\nadd_action( 'init', function () use ( $wpide_template_post_type, $wpide_template_blocks, $wpide_template_lock ) {\n $object = get_post_type_object( $wpide_template_post_type );\n\n if ( ! $object ) {\n return;\n }\n\n $object->template = $wpide_template_blocks;\n\n if ( $wpide_template_lock ) {\n $object->template_lock = $wpide_template_lock;\n }\n}, 20 );",
"requires": [],
"notes": "Change the post type, the blocks and the lock. Lock 'insert' stops blocks being added or removed; 'all' also stops moving them."
},
{
"id": "skip-pre-publish-checks",
"version": 1,
"title": "Skip the Pre-Publish Checks Panel by Default",
"description": "Publishes posts with a single click instead of opening the \"Are you ready to publish?\" panel first. Each user can still switch the panel back on in the editor preferences.",
"category": "gutenberg",
"tags": [
"editor",
"publishing",
"preferences"
],
"code_type": "php",
"insert_method": "auto",
"location": "admin_only",
"insert_number": 1,
"code": "add_action( 'enqueue_block_editor_assets', function () {\n wp_add_inline_script(\n 'wp-preferences',\n 'wp.domReady(function(){(window._wpLoadBlockEditor||Promise.resolve()).then(function(){wp.data.dispatch(\"core/preferences\").setDefaults(\"core\",{isPublishSidebarEnabled:false});});});'\n );\n} );",
"requires": [],
"notes": ""
},
{
"id": "disable-template-editing-from-posts",
"version": 1,
"title": "Hide Template Editing in the Post Editor",
"description": "Removes the option to switch to and edit the site template from inside the post and page editor, so content editors cannot change the site layout by accident.",
"category": "gutenberg",
"tags": [
"templates",
"editor",
"permissions"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_filter( 'block_editor_settings_all', function ( $settings, $context ) {\n if ( ! empty( $context->post ) ) {\n $settings['supportsTemplateMode'] = false;\n }\n\n return $settings;\n}, 10, 2 );",
"requires": [],
"notes": "Administrators can still edit templates in the Site Editor."
},
{
"id": "disable-duotone-filters",
"version": 1,
"title": "Disable Duotone Filters",
"description": "Removes the duotone image filter controls from the editor and stops WordPress outputting the default duotone presets.",
"category": "gutenberg",
"tags": [
"duotone",
"images",
"editor"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_filter( 'wp_theme_json_data_theme', function ( $theme_json ) {\n return $theme_json->update_with( array(\n 'version' => 3,\n 'settings' => array(\n 'color' => array(\n 'customDuotone' => false,\n 'defaultDuotone' => false,\n 'duotone' => array(),\n ),\n ),\n ) );\n} );",
"requires": [],
"notes": ""
},
{
"id": "simplify-typography-controls",
"version": 1,
"title": "Simplify the Editor's Typography Controls",
"description": "Hides letter spacing, text transform, text decoration, font style, font weight, line height and writing mode controls, leaving a calmer sidebar for content editors.",
"category": "gutenberg",
"tags": [
"typography",
"editor",
"simplify"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_filter( 'wp_theme_json_data_theme', function ( $theme_json ) {\n return $theme_json->update_with( array(\n 'version' => 3,\n 'settings' => array(\n 'typography' => array(\n 'letterSpacing' => false,\n 'textTransform' => false,\n 'textDecoration' => false,\n 'fontStyle' => false,\n 'fontWeight' => false,\n 'lineHeight' => false,\n 'writingMode' => false,\n ),\n ),\n ) );\n} );",
"requires": [],
"notes": "Remove lines from the list to keep a control."
},
{
"id": "modern-block-features-classic-themes",
"version": 1,
"title": "Turn On Modern Block Features in Classic Themes",
"description": "Enables wide and full alignments, responsive embeds, spacing, border, line height and link color controls for classic themes that never declared them.",
"category": "gutenberg",
"tags": [
"classic-themes",
"alignments",
"blocks"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'after_setup_theme', function () {\n if ( wp_is_block_theme() ) {\n return;\n }\n\n foreach ( array( 'align-wide', 'responsive-embeds', 'custom-spacing', 'custom-line-height', 'custom-units', 'link-color', 'border', 'appearance-tools' ) as $feature ) {\n add_theme_support( $feature );\n }\n}, 20 );",
"requires": [],
"notes": "Your theme's CSS decides how wide alignments look; test a few pages after enabling it."
},
{
"id": "outline-blocks-while-editing",
"version": 1,
"title": "Outline Blocks While Editing",
"description": "Draws a faint dashed outline around blocks as you hover over them in the editor, making nested groups, columns and empty blocks easy to see.",
"category": "gutenberg",
"tags": [
"editor",
"outline",
"layout"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'enqueue_block_assets', function () {\n if ( ! is_admin() ) {\n return;\n }\n\n wp_register_style( 'wpide-block-outlines', false, array(), '1.0' );\n wp_enqueue_style( 'wpide-block-outlines' );\n wp_add_inline_style( 'wpide-block-outlines', '.editor-styles-wrapper .wp-block:hover{outline:1px dashed rgba(120,120,120,.45);outline-offset:2px;}.editor-styles-wrapper .wp-block.is-selected:hover{outline:none;}' );\n} );",
"requires": [],
"notes": ""
},
{
"id": "hide-custom-html-block-from-inserter",
"version": 1,
"title": "Hide the Custom HTML Block From Non-Administrators",
"description": "Removes the Custom HTML block from the inserter for users who cannot post unfiltered HTML, so authors use proper blocks instead of pasting raw markup.",
"category": "gutenberg",
"tags": [
"blocks",
"html",
"permissions"
],
"code_type": "php",
"insert_method": "auto",
"location": "admin_only",
"insert_number": 1,
"code": "add_action( 'enqueue_block_editor_assets', function () {\n if ( current_user_can( 'unfiltered_html' ) ) {\n return;\n }\n\n wp_add_inline_script(\n 'wp-blocks',\n 'wp.hooks.addFilter(\"blocks.registerBlockType\",\"wpide/hide-html-block\",function(settings,name){if(name===\"core/html\"){settings.supports=Object.assign({},settings.supports,{inserter:false});}return settings;});'\n );\n} );",
"requires": [],
"notes": "Existing Custom HTML blocks stay editable; only inserting new ones is hidden."
},
{
"id": "synced-pattern-shortcode",
"version": 1,
"title": "Synced Pattern Shortcode",
"description": "Adds a [synced_pattern] shortcode that prints a synced pattern (formerly reusable block) anywhere shortcodes work, such as classic widgets, page builders or theme files.",
"category": "gutenberg",
"tags": [
"patterns",
"shortcode",
"reusable-blocks"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_shortcode( 'synced_pattern', function ( $atts ) {\n static $depth = 0;\n\n $atts = shortcode_atts( array( 'id' => 0 ), $atts, 'synced_pattern' );\n $pattern = get_post( absint( $atts['id'] ) );\n\n if ( ! $pattern || 'wp_block' !== $pattern->post_type || 'publish' !== $pattern->post_status || $depth > 2 ) {\n return '';\n }\n\n $depth++;\n $html = do_blocks( $pattern->post_content );\n $depth--;\n\n return $html;\n} );",
"requires": [],
"notes": "Example: [synced_pattern id=\"123\"]. Find the ID in Appearance > Patterns by opening the pattern and checking the address bar."
},
{
"id": "default-image-size-large",
"version": 1,
"title": "Insert Images at Large Size by Default",
"description": "Makes new Image blocks and media inserted in the editor use the Large size by default, instead of the full original file.",
"category": "gutenberg",
"tags": [
"images",
"editor",
"defaults"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Default size for inserted images.\n$wpide_default_image_size = 'large';\n\nadd_filter( 'pre_option_image_default_size', function () use ( $wpide_default_image_size ) {\n return $wpide_default_image_size;\n} );",
"requires": [],
"notes": "Change large to medium or another registered size."
},
{
"id": "disable-theme-block-patterns",
"version": 1,
"title": "Disable the Theme's Block Patterns",
"description": "Removes the patterns bundled with your active theme from the inserter, for sites that only want their own patterns.",
"category": "gutenberg",
"tags": [
"patterns",
"themes",
"editor"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'init', function () {\n $registry = WP_Block_Patterns_Registry::get_instance();\n $prefixes = array_unique( array( get_stylesheet() . '/', get_template() . '/' ) );\n\n foreach ( $registry->get_all_registered() as $pattern ) {\n foreach ( $prefixes as $prefix ) {\n if ( 0 === strpos( $pattern['name'], $prefix ) ) {\n unregister_block_pattern( $pattern['name'] );\n break;\n }\n }\n }\n}, 99 );",
"requires": [],
"notes": "Patterns from WordPress core and plugins are not affected. Use Disable Core Block Patterns for those."
},
{
"id": "turn-off-starter-patterns-modal",
"version": 1,
"title": "Turn Off the Starter Patterns Window for New Pages",
"description": "Stops the \"Choose a pattern\" window from popping up every time someone creates a new page. Users can switch it back on in the editor preferences.",
"category": "gutenberg",
"tags": [
"patterns",
"editor",
"preferences"
],
"code_type": "php",
"insert_method": "auto",
"location": "admin_only",
"insert_number": 1,
"code": "add_action( 'enqueue_block_editor_assets', function () {\n wp_add_inline_script(\n 'wp-preferences',\n 'wp.domReady(function(){(window._wpLoadBlockEditor||Promise.resolve()).then(function(){wp.data.dispatch(\"core/preferences\").setDefaults(\"core\",{enableChoosePatternModal:false});});});'\n );\n} );",
"requires": [],
"notes": ""
},
{
"id": "limit-heading-levels",
"version": 1,
"title": "Limit Heading Levels in the Editor",
"description": "Shows only the heading levels you allow (for example H2 to H4) in the Heading block toolbar, so editors keep a clean document outline and never add a second H1.",
"category": "gutenberg",
"tags": [
"headings",
"accessibility",
"editor"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Heading levels to offer.\n$wpide_heading_levels = array( 2, 3, 4 );\n\nadd_filter( 'register_block_type_args', function ( $args, $block_type ) use ( $wpide_heading_levels ) {\n if ( 'core/heading' !== $block_type || ! isset( $args['attributes'] ) ) {\n return $args;\n }\n\n $args['attributes']['levelOptions'] = array(\n 'type' => 'array',\n 'default' => array_map( 'intval', $wpide_heading_levels ),\n );\n\n return $args;\n}, 10, 2 );",
"requires": [],
"notes": "Requires WordPress 6.7 or newer. Existing headings keep their level."
},
{
"id": "remove-rich-text-formats",
"version": 1,
"title": "Remove Formatting Buttons From the Block Toolbar",
"description": "Removes rarely needed formatting options, such as text color highlight, inline image, keyboard input and language, from the rich text toolbar.",
"category": "gutenberg",
"tags": [
"formatting",
"toolbar",
"editor"
],
"code_type": "php",
"insert_method": "auto",
"location": "admin_only",
"insert_number": 1,
"code": "// Formats to remove from the toolbar.\n$wpide_removed_formats = array( 'core/text-color', 'core/image', 'core/keyboard', 'core/language' );\n\nadd_action( 'enqueue_block_editor_assets', function () use ( $wpide_removed_formats ) {\n wp_add_inline_script(\n 'wp-rich-text',\n 'wp.domReady(function(){(window._wpLoadBlockEditor||Promise.resolve()).then(function(){' . wp_json_encode( array_values( $wpide_removed_formats ) ) . '.forEach(function(name){if(wp.data.select(\"core/rich-text\").getFormatType(name)){wp.richText.unregisterFormatType(name);}});});});'\n );\n} );",
"requires": [],
"notes": "Format names include core/text-color, core/image, core/keyboard, core/language, core/subscript, core/superscript, core/code and core/strikethrough."
},
{
"id": "hide-blocks-by-device-classes",
"version": 1,
"title": "Hide Blocks on Mobile or Desktop With a CSS Class",
"description": "Adds hide-on-mobile, hide-on-tablet and hide-on-desktop classes you can put in any block's \"Additional CSS class\" field to show it only on certain screen sizes.",
"category": "gutenberg",
"tags": [
"responsive",
"css",
"blocks"
],
"code_type": "css",
"insert_method": "auto",
"location": "site_wide_header",
"insert_number": 1,
"code": "@media (max-width: 599px) {\n .hide-on-mobile {\n display: none !important;\n }\n}\n\n@media (min-width: 600px) and (max-width: 1023px) {\n .hide-on-tablet {\n display: none !important;\n }\n}\n\n@media (min-width: 1024px) {\n .hide-on-desktop {\n display: none !important;\n }\n}",
"requires": [],
"notes": "Breakpoints are 600px and 1024px; change them to match your theme."
},
{
"id": "default-editor-preferences",
"version": 1,
"title": "Default Block Editor Preferences for Everyone",
"description": "Sets sensible defaults for every user of the block editor, such as the top toolbar, the List View opened and button text labels, while each person can still change them.",
"category": "gutenberg",
"tags": [
"editor",
"preferences",
"defaults"
],
"code_type": "php",
"insert_method": "auto",
"location": "admin_only",
"insert_number": 1,
"code": "// Editor preferences (true or false).\n$wpide_editor_defaults = array(\n 'fixedToolbar' => true,\n 'showListViewByDefault' => true,\n 'showIconLabels' => false,\n 'showBlockBreadcrumbs' => true,\n);\n\nadd_action( 'enqueue_block_editor_assets', function () use ( $wpide_editor_defaults ) {\n wp_add_inline_script(\n 'wp-preferences',\n 'wp.domReady(function(){(window._wpLoadBlockEditor||Promise.resolve()).then(function(){wp.data.dispatch(\"core/preferences\").setDefaults(\"core\",' . wp_json_encode( array_map( 'boolval', $wpide_editor_defaults ) ) . ');});});'\n );\n} );",
"requires": [],
"notes": "Only defaults change; anything a user has already set in Preferences wins. Set a value to true or false to taste."
},
{
"id": "button-hover-effects-scss",
"version": 1,
"title": "Button Block Hover Effects (SCSS)",
"description": "Adds a smooth lift, shadow and color shift when visitors hover over or focus Button blocks, with motion turned off for people who prefer reduced motion.",
"category": "gutenberg",
"tags": [
"scss",
"buttons",
"hover"
],
"code_type": "scss",
"insert_method": "auto",
"location": "site_wide_header",
"insert_number": 1,
"code": "$lift: 2px;\n$shadow: 0 6px 16px rgba(0, 0, 0, 0.18);\n$speed: 0.2s;\n\n.wp-block-button__link,\n.wp-element-button {\n transition: transform $speed ease, box-shadow $speed ease, filter $speed ease;\n\n &:hover,\n &:focus-visible {\n transform: translateY(-$lift);\n box-shadow: $shadow;\n filter: brightness(1.08);\n }\n\n &:active {\n transform: translateY(0);\n box-shadow: none;\n }\n}\n\n@media (prefers-reduced-motion: reduce) {\n .wp-block-button__link,\n .wp-element-button {\n transition: none;\n\n &:hover,\n &:focus-visible {\n transform: none;\n }\n }\n}",
"requires": [],
"notes": "Adjust the lift distance and shadow in the variables."
},
{
"id": "site-details-block-bindings",
"version": 1,
"title": "Bind Blocks to Site Details (Block Bindings)",
"description": "Registers a Block Bindings source so Paragraph, Heading and Button blocks can display the site name, tagline, URL or current year and stay up to date automatically.",
"category": "gutenberg",
"tags": [
"block-bindings",
"blocks",
"site-name"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'init', function () {\n if ( ! function_exists( 'register_block_bindings_source' ) ) {\n return;\n }\n\n register_block_bindings_source( 'wpide/site-details', array(\n 'label' => 'Site details',\n 'get_value_callback' => function ( $source_args ) {\n $key = isset( $source_args['key'] ) ? $source_args['key'] : '';\n\n switch ( $key ) {\n case 'name':\n return esc_html( get_bloginfo( 'name' ) );\n case 'tagline':\n return esc_html( get_bloginfo( 'description' ) );\n case 'url':\n return esc_url( home_url( '/' ) );\n case 'year':\n return esc_html( wp_date( 'Y' ) );\n }\n\n return null;\n },\n ) );\n} );",
"requires": [],
"notes": "Requires WordPress 6.5 or newer. In the code editor use for example {\"metadata\":{\"bindings\":{\"content\":{\"source\":\"wpide/site-details\",\"args\":{\"key\":\"year\"}}}}} on a Paragraph block. Keys are name, tagline, url and year."
},
{
"id": "custom-field-for-block-bindings",
"version": 1,
"title": "Make a Custom Field Usable in Blocks",
"description": "Registers a custom field (such as a subtitle) with the REST API so it can be connected to Paragraph or Heading blocks through Block Bindings and edited right in the block.",
"category": "gutenberg",
"tags": [
"block-bindings",
"custom-fields",
"meta"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Post type and custom field name.\n$wpide_bound_post_type = 'post';\n$wpide_bound_meta_key = 'subtitle';\n\nadd_action( 'init', function () use ( $wpide_bound_post_type, $wpide_bound_meta_key ) {\n register_post_meta( $wpide_bound_post_type, $wpide_bound_meta_key, array(\n 'type' => 'string',\n 'single' => true,\n 'show_in_rest' => true,\n 'default' => '',\n 'sanitize_callback' => 'sanitize_text_field',\n 'label' => ucfirst( str_replace( array( '-', '_' ), ' ', $wpide_bound_meta_key ) ),\n 'auth_callback' => function ( $allowed, $meta_key, $post_id ) {\n return current_user_can( 'edit_post', $post_id );\n },\n ) );\n} );",
"requires": [],
"notes": "Requires WordPress 6.5 or newer. Bind it with {\"metadata\":{\"bindings\":{\"content\":{\"source\":\"core/post-meta\",\"args\":{\"key\":\"subtitle\"}}}}}. Change the post type and field name at the top."
},
{
"id": "details-block-accordion-scss",
"version": 1,
"title": "Accordion Style for the Details Block (SCSS)",
"description": "Styles the core Details block as a polished accordion with borders, a rotating plus icon and comfortable spacing, so FAQs look finished without a plugin.",
"category": "gutenberg",
"tags": [
"scss",
"details",
"accordion"
],
"code_type": "scss",
"insert_method": "auto",
"location": "site_wide_header",
"insert_number": 1,
"code": "$border: rgba(0, 0, 0, 0.15);\n$accent: #2271b1;\n\n.wp-block-details {\n margin: 0;\n padding: 0;\n border: 1px solid $border;\n\n & + .wp-block-details {\n border-top: 0;\n }\n\n summary {\n position: relative;\n padding: 1em 3em 1em 1.25em;\n font-weight: 600;\n list-style: none;\n cursor: pointer;\n\n &::-webkit-details-marker {\n display: none;\n }\n\n &::after {\n content: \"+\";\n position: absolute;\n top: 50%;\n right: 1.25em;\n font-size: 1.4em;\n line-height: 1;\n transform: translateY(-50%);\n transition: transform 0.2s ease;\n }\n\n &:focus-visible {\n outline: 2px solid $accent;\n outline-offset: -2px;\n }\n }\n\n &[open] summary::after {\n transform: translateY(-50%) rotate(45deg);\n }\n\n > :not(summary) {\n margin: 0;\n padding: 0 1.25em 1em;\n }\n}",
"requires": [],
"notes": "Consecutive Details blocks join into one accordion list."
},
{
"id": "utility-classes-scss",
"version": 1,
"title": "Utility Classes for Blocks (SCSS)",
"description": "Adds a small set of classes, such as has-shadow, is-rounded, has-hover-lift and text-balance, that editors can type into any block's \"Additional CSS class\" field.",
"category": "gutenberg",
"tags": [
"scss",
"utilities",
"blocks"
],
"code_type": "scss",
"insert_method": "auto",
"location": "site_wide_header",
"insert_number": 1,
"code": "$radius: 10px;\n$shadow: 0 6px 24px rgba(0, 0, 0, 0.1);\n\n.has-shadow {\n box-shadow: $shadow;\n}\n\n.is-rounded,\n.is-rounded img {\n overflow: hidden;\n border-radius: $radius;\n}\n\n.has-hover-lift {\n transition: transform 0.2s ease, box-shadow 0.2s ease;\n\n &:hover {\n transform: translateY(-4px);\n box-shadow: $shadow;\n }\n}\n\n.text-balance {\n text-wrap: balance;\n}\n\n.is-sticky-top {\n position: sticky;\n top: 1.5rem;\n}\n\n@media (prefers-reduced-motion: reduce) {\n .has-hover-lift {\n transition: none;\n\n &:hover {\n transform: none;\n }\n }\n}",
"requires": [],
"notes": "Add more utilities in the same style. The class names have no prefix so editors can remember them easily."
},
{
"id": "legal-disclaimer-blocks-after-content",
"version": 1,
"title": "Legal Disclaimer After Content (Blocks)",
"description": "Adds a small, separated disclaimer built from blocks at the end of posts and pages, for example a \"not financial or medical advice\" notice.",
"category": "gutenberg",
"tags": [
"blocks",
"disclaimer",
"legal"
],
"code_type": "blocks",
"insert_method": "auto",
"location": "after_content",
"insert_number": 1,
"code": "\n\n\n\n\n
Disclaimer: This content is for general information only and is not professional advice. Please consult a qualified professional before making decisions based on it.
\n",
"requires": [],
"notes": "Edit the wording in the snippet editor and use conditions to limit it to certain categories if needed."
},
{
"id": "force-https-redirect",
"version": 1,
"title": "Force HTTPS on the Front End",
"description": "Sends visitors who open a page over plain HTTP to the secure HTTPS address with a permanent redirect, once your site URL is set to https.",
"category": "redirects",
"tags": [
"https",
"ssl",
"security"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'template_redirect', function () {\n if ( is_ssl() || 'https' !== wp_parse_url( home_url(), PHP_URL_SCHEME ) ) {\n return;\n }\n\n $forwarded = isset( $_SERVER['HTTP_X_FORWARDED_PROTO'] ) ? strtolower( sanitize_text_field( wp_unslash( $_SERVER['HTTP_X_FORWARDED_PROTO'] ) ) ) : '';\n $visitor = isset( $_SERVER['HTTP_CF_VISITOR'] ) ? sanitize_text_field( wp_unslash( $_SERVER['HTTP_CF_VISITOR'] ) ) : '';\n\n if ( false !== strpos( $forwarded, 'https' ) || false !== strpos( $visitor, 'https' ) ) {\n return;\n }\n\n $host = wp_parse_url( home_url(), PHP_URL_HOST );\n $port = wp_parse_url( home_url(), PHP_URL_PORT );\n $request = isset( $_SERVER['REQUEST_URI'] ) ? wp_unslash( $_SERVER['REQUEST_URI'] ) : '/';\n\n wp_safe_redirect( 'https://' . $host . ( $port ? ':' . $port : '' ) . $request, 301 );\n exit;\n}, 0 );",
"requires": [],
"notes": "Only runs when the Site Address already starts with https. Proxies and CDNs that report HTTPS through standard headers are detected, so it does not loop behind Cloudflare or a load balancer."
},
{
"id": "www-host-consistency",
"version": 1,
"title": "Redirect to the www or Non-www Version of Your Domain",
"description": "Sends visitors who arrive on the other version of your domain (with or without www) to the one set as your Site Address, so search engines see a single site.",
"category": "redirects",
"tags": [
"www",
"domain",
"canonical"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'template_redirect', function () {\n $home_host = strtolower( (string) wp_parse_url( home_url(), PHP_URL_HOST ) );\n $request = isset( $_SERVER['HTTP_HOST'] ) ? strtolower( sanitize_text_field( wp_unslash( $_SERVER['HTTP_HOST'] ) ) ) : '';\n $request = preg_replace( '/:\\d+$/', '', $request );\n\n if ( '' === $request || $request === $home_host ) {\n return;\n }\n\n $bare_home = preg_replace( '/^www\\./', '', $home_host );\n $bare_request = preg_replace( '/^www\\./', '', $request );\n\n if ( $bare_home !== $bare_request ) {\n return;\n }\n\n $scheme = wp_parse_url( home_url(), PHP_URL_SCHEME );\n $uri = isset( $_SERVER['REQUEST_URI'] ) ? wp_unslash( $_SERVER['REQUEST_URI'] ) : '/';\n\n wp_safe_redirect( $scheme . '://' . $home_host . $uri, 301 );\n exit;\n}, 0 );",
"requires": [],
"notes": "Your host must point both versions to this site. A redirect at the server or DNS level is faster when available."
},
{
"id": "lowercase-url-redirect",
"version": 1,
"title": "Redirect URLs With Capital Letters to Lowercase",
"description": "Permanently redirects addresses typed or linked with capital letters, such as /About-Us/, to their lowercase form, avoiding duplicate URLs and broken links.",
"category": "redirects",
"tags": [
"urls",
"lowercase",
"seo"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'template_redirect', function () {\n $uri = isset( $_SERVER['REQUEST_URI'] ) ? wp_unslash( $_SERVER['REQUEST_URI'] ) : '';\n $path = (string) wp_parse_url( $uri, PHP_URL_PATH );\n\n if ( '' === $path || ! preg_match( '/[A-Z]/', preg_replace( '/%[0-9A-Fa-f]{2}/', '', $path ) ) ) {\n return;\n }\n\n $lower = preg_replace_callback( '/(%[0-9A-Fa-f]{2})|([A-Z]+)/', function ( $m ) {\n return '' !== $m[1] ? $m[1] : strtolower( $m[2] );\n }, $path );\n\n if ( null === $lower || $lower === $path ) {\n return;\n }\n\n $query = (string) wp_parse_url( $uri, PHP_URL_QUERY );\n $scheme = wp_parse_url( home_url(), PHP_URL_SCHEME );\n $host = wp_parse_url( home_url(), PHP_URL_HOST );\n $port = wp_parse_url( home_url(), PHP_URL_PORT );\n\n wp_safe_redirect( $scheme . '://' . $host . ( $port ? ':' . $port : '' ) . $lower . ( '' !== $query ? '?' . $query : '' ), 301 );\n exit;\n}, 1 );",
"requires": [],
"notes": "Encoded characters such as %C3%A9 are left as they are. Query strings are kept unchanged."
},
{
"id": "redirect-post-type-singles-to-archive",
"version": 1,
"title": "Send Single Entries of a Post Type to Its Archive",
"description": "Redirects the single pages of post types that only make sense in a list, such as testimonials, FAQs or team members, to their archive or another page.",
"category": "redirects",
"tags": [
"post-types",
"redirect",
"archives"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Post types whose single pages redirect.\n$wpide_list_only_types = array( 'testimonial' );\n// Optional fixed target path, such as '/reviews/'. Leave empty to use the archive.\n$wpide_list_only_target = '';\n\nadd_action( 'template_redirect', function () use ( $wpide_list_only_types, $wpide_list_only_target ) {\n if ( ! is_singular( $wpide_list_only_types ) ) {\n return;\n }\n\n if ( '' !== $wpide_list_only_target ) {\n $target = home_url( $wpide_list_only_target );\n } else {\n $archive = get_post_type_archive_link( get_post_type() );\n $target = $archive ? $archive : home_url( '/' );\n }\n\n wp_safe_redirect( $target, 301 );\n exit;\n} );",
"requires": [],
"notes": "Set the post types and, optionally, a fixed target path. Without a target, the post type archive (or the homepage) is used."
},
{
"id": "empty-parent-page-to-first-child",
"version": 1,
"title": "Send Empty Parent Pages to Their First Child Page",
"description": "When a parent page has no content of its own (it only groups subpages in the menu), visitors who open it are sent to its first child page instead of a blank page.",
"category": "redirects",
"tags": [
"pages",
"redirect",
"navigation"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'template_redirect', function () {\n if ( ! is_page() || is_front_page() ) {\n return;\n }\n\n $page = get_queried_object();\n\n if ( ! $page instanceof WP_Post || '' !== trim( $page->post_content ) ) {\n return;\n }\n\n $children = get_posts( array(\n 'post_type' => 'page',\n 'post_parent' => $page->ID,\n 'post_status' => 'publish',\n 'orderby' => array( 'menu_order' => 'ASC', 'title' => 'ASC' ),\n 'numberposts' => 1,\n ) );\n\n if ( $children ) {\n wp_safe_redirect( get_permalink( $children[0] ), 302 );\n exit;\n }\n} );",
"requires": [],
"notes": "Only pages whose content is completely empty are redirected; the first child is chosen by menu order, then title. The redirect is temporary, so adding content later works right away."
},
{
"id": "wildcard-redirects",
"version": 1,
"title": "Wildcard Redirects for Moved Sections",
"description": "Redirects whole groups of old URLs with simple * patterns, for example everything under /old-blog/ to the same address under /blog/, without a redirect plugin.",
"category": "redirects",
"tags": [
"redirects",
"wildcard",
"migration"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Pattern => target. * matches anything; $1, $2 ... insert the matched text. Examples:\n// '/old-blog/*' => '/blog/$1',\n// '/products/*/manual/' => '/docs/$1/',\n$wpide_wildcard_redirects = array();\n\nadd_action( 'template_redirect', function () use ( $wpide_wildcard_redirects ) {\n $path = isset( $_SERVER['REQUEST_URI'] ) ? (string) wp_parse_url( wp_unslash( $_SERVER['REQUEST_URI'] ), PHP_URL_PATH ) : '';\n\n if ( '' === $path ) {\n return;\n }\n\n foreach ( $wpide_wildcard_redirects as $pattern => $target ) {\n $regex = '#^' . str_replace( '\\*', '(.*?)', preg_quote( $pattern, '#' ) ) . '$#i';\n\n if ( ! preg_match( $regex, $path, $matches ) ) {\n continue;\n }\n\n $url = preg_replace_callback( '/\\$(\\d+)/', function ( $ref ) use ( $matches ) {\n return isset( $matches[ (int) $ref[1] ] ) ? $matches[ (int) $ref[1] ] : '';\n }, $target );\n\n $url = preg_match( '#^https?://#i', $url ) ? $url : home_url( $url );\n $same_host = ! wp_parse_url( $url, PHP_URL_HOST ) || wp_parse_url( $url, PHP_URL_HOST ) === wp_parse_url( home_url(), PHP_URL_HOST );\n\n if ( $same_host && untrailingslashit( (string) wp_parse_url( $url, PHP_URL_PATH ) ) === untrailingslashit( $path ) ) {\n return;\n }\n\n wp_safe_redirect( $url, 301 );\n exit;\n }\n}, 1 );",
"requires": [],
"notes": "The rule list is empty by default; add your own using the examples. Use * for any text and $1, $2 in the target for what each * matched. On a subdirectory install include the subdirectory in the patterns. Redirects to the same address are skipped, so a rule cannot loop."
},
{
"id": "redirect-404-to-search",
"version": 1,
"title": "Turn 404 Errors Into Search Results",
"description": "Sends visitors who hit a missing page to a site search for the words in the broken address, so they land on likely matches instead of a dead end.",
"category": "redirects",
"tags": [
"404",
"search",
"redirect"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'template_redirect', function () {\n if ( ! is_404() ) {\n return;\n }\n\n $path = isset( $_SERVER['REQUEST_URI'] ) ? (string) wp_parse_url( wp_unslash( $_SERVER['REQUEST_URI'] ), PHP_URL_PATH ) : '';\n\n if ( '' === $path || preg_match( '/\\.[a-z0-9]{2,5}$/i', $path ) ) {\n return;\n }\n\n $segments = array_filter( explode( '/', trim( rawurldecode( $path ), '/' ) ) );\n $last = $segments ? end( $segments ) : '';\n $words = trim( preg_replace( '/[^\\p{L}\\p{N}]+/u', ' ', (string) $last ) );\n\n if ( '' === $words || is_numeric( $words ) ) {\n return;\n }\n\n wp_safe_redirect( add_query_arg( 's', rawurlencode( $words ), home_url( '/' ) ), 302 );\n exit;\n} );",
"requires": [],
"notes": "Missing files such as images, scripts and PDFs still return a normal 404."
},
{
"id": "log-404-errors",
"version": 1,
"title": "Log 404 Errors Under Tools",
"description": "Records the addresses visitors request that do not exist, with hit counts, last seen time and referring page, and lists them under Tools > 404 Log so you can fix or redirect them.",
"category": "redirects",
"tags": [
"404",
"logging",
"broken-links"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'template_redirect', function () {\n if ( ! is_404() ) {\n return;\n }\n\n $path = isset( $_SERVER['REQUEST_URI'] ) ? substr( sanitize_text_field( wp_unslash( $_SERVER['REQUEST_URI'] ) ), 0, 255 ) : '';\n\n if ( '' === $path ) {\n return;\n }\n\n $referrer = wp_get_raw_referer();\n $log = get_option( 'wpide_404_log', array() );\n $log = is_array( $log ) ? $log : array();\n $entry = isset( $log[ $path ] ) ? $log[ $path ] : array( 'count' => 0, 'last' => 0, 'referrer' => '' );\n\n $entry['count']++;\n $entry['last'] = time();\n\n if ( $referrer ) {\n $entry['referrer'] = substr( esc_url_raw( $referrer ), 0, 255 );\n }\n\n $log[ $path ] = $entry;\n\n if ( count( $log ) > 200 ) {\n uasort( $log, function ( $a, $b ) {\n return $b['last'] <=> $a['last'];\n } );\n $log = array_slice( $log, 0, 200, true );\n }\n\n update_option( 'wpide_404_log', $log, false );\n} );\n\nadd_action( 'admin_menu', function () {\n add_management_page( '404 Log', '404 Log', 'manage_options', 'wpide-404-log', function () {\n if ( isset( $_POST['wpide_clear_404_log'] ) && check_admin_referer( 'wpide_clear_404_log' ) ) {\n delete_option( 'wpide_404_log' );\n echo '
';\n } );\n} );",
"requires": [],
"notes": "Keeps the 200 most recent distinct addresses in one option. Clear the log from the same screen."
},
{
"id": "logged-in-homepage-redirect",
"version": 1,
"title": "Send Logged-In Members From the Homepage to Their Page",
"description": "Redirects logged-in users who visit the homepage to a members area, dashboard or account page, while guests still see the normal homepage.",
"category": "redirects",
"tags": [
"members",
"homepage",
"redirect"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Path members are sent to.\n$wpide_member_home = '/members/';\n// Users with this capability are not redirected.\n$wpide_member_home_skip = 'edit_posts';\n\nadd_action( 'template_redirect', function () use ( $wpide_member_home, $wpide_member_home_skip ) {\n if ( ! is_front_page() || is_paged() || ! is_user_logged_in() || current_user_can( $wpide_member_home_skip ) ) {\n return;\n }\n\n $target = home_url( $wpide_member_home );\n\n // Only redirect to a page that exists, and never to the homepage itself.\n if ( untrailingslashit( $target ) === untrailingslashit( home_url( '/' ) ) || ! url_to_postid( $target ) ) {\n return;\n }\n\n wp_safe_redirect( $target, 302 );\n exit;\n} );",
"requires": [],
"notes": "Nothing happens until the target page exists. Users with the capability in $wpide_member_home_skip (editors and up by default) still see the homepage."
},
{
"id": "per-post-redirect-field",
"version": 1,
"title": "Redirect Field for Posts and Pages",
"description": "Adds a \"Redirect to\" box to the post and page editor; when filled in, visitors who open that post are sent to the address you entered, on your site or elsewhere.",
"category": "redirects",
"tags": [
"redirect",
"posts",
"meta-box"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'add_meta_boxes', function () {\n add_meta_box( 'wpide-redirect', 'Redirect to', function ( $post ) {\n wp_nonce_field( 'wpide_redirect_save', 'wpide_redirect_nonce' );\n echo '';\n echo 'ID, '_wpide_redirect_url', true ) ) . '\" />';\n echo '
Visitors to this page are sent to this address. Leave empty to turn it off.
';\n }, array( 'post', 'page' ), 'side', 'low' );\n} );\n\nadd_action( 'save_post', function ( $post_id ) {\n if ( ! isset( $_POST['wpide_redirect_nonce'] ) || ! wp_verify_nonce( sanitize_text_field( wp_unslash( $_POST['wpide_redirect_nonce'] ) ), 'wpide_redirect_save' ) ) {\n return;\n }\n\n if ( ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) || wp_is_post_revision( $post_id ) || ! current_user_can( 'edit_post', $post_id ) ) {\n return;\n }\n\n $url = isset( $_POST['wpide_redirect_url'] ) ? esc_url_raw( wp_unslash( $_POST['wpide_redirect_url'] ), array( 'http', 'https' ) ) : '';\n\n if ( '' === $url ) {\n delete_post_meta( $post_id, '_wpide_redirect_url' );\n } else {\n update_post_meta( $post_id, '_wpide_redirect_url', $url );\n }\n} );\n\nadd_action( 'template_redirect', function () {\n if ( ! is_singular() || is_preview() ) {\n return;\n }\n\n $url = get_post_meta( get_queried_object_id(), '_wpide_redirect_url', true );\n\n if ( ! $url || untrailingslashit( $url ) === untrailingslashit( (string) get_permalink( get_queried_object_id() ) ) ) {\n return;\n }\n\n wp_redirect( esc_url_raw( $url ), 301, 'WordPress' ); // phpcs:ignore WordPress.Security.SafeRedirect -- the editor chose this address.\n exit;\n} );",
"requires": [],
"notes": "Uses a permanent (301) redirect. Clear the field to switch it off. Only users who can edit the post can set it."
},
{
"id": "require-login-for-selected-pages",
"version": 1,
"title": "Require Login for Selected Pages",
"description": "Sends visitors who are not logged in to the login screen when they open the pages you list, and brings them back to the page after they log in.",
"category": "redirects",
"tags": [
"login",
"members",
"pages"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// IDs of the pages that need a login.\n$wpide_protected_page_ids = array( 0 );\n\nadd_action( 'template_redirect', function () use ( $wpide_protected_page_ids ) {\n if ( is_user_logged_in() || ! is_singular() ) {\n return;\n }\n\n if ( in_array( get_queried_object_id(), array_map( 'absint', $wpide_protected_page_ids ), true ) ) {\n wp_safe_redirect( wp_login_url( get_permalink( get_queried_object_id() ) ) );\n exit;\n }\n} );",
"requires": [],
"notes": "List page or post IDs. Child pages are not included automatically."
},
{
"id": "old-domain-redirect",
"version": 1,
"title": "Redirect an Old Domain to This Site",
"description": "Permanently redirects every request that arrives on your previous domain to the same address on your current domain, after a rebrand or domain move.",
"category": "redirects",
"tags": [
"domain",
"migration",
"redirect"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Old host names that should redirect to the current site.\n$wpide_old_domains = array( 'old-example.com', 'www.old-example.com' );\n\nadd_action( 'template_redirect', function () use ( $wpide_old_domains ) {\n $request = isset( $_SERVER['HTTP_HOST'] ) ? strtolower( sanitize_text_field( wp_unslash( $_SERVER['HTTP_HOST'] ) ) ) : '';\n $request = preg_replace( '/:\\d+$/', '', $request );\n $home = strtolower( (string) wp_parse_url( home_url(), PHP_URL_HOST ) );\n\n if ( '' === $request || $request === $home || ! in_array( $request, array_map( 'strtolower', $wpide_old_domains ), true ) ) {\n return;\n }\n\n $uri = isset( $_SERVER['REQUEST_URI'] ) ? wp_unslash( $_SERVER['REQUEST_URI'] ) : '/';\n\n wp_safe_redirect( wp_parse_url( home_url(), PHP_URL_SCHEME ) . '://' . $home . $uri, 301 );\n exit;\n}, 0 );",
"requires": [],
"notes": "The old domain must still point to this hosting account. List each old host name, including www versions."
},
{
"id": "redirect-old-date-based-urls",
"version": 1,
"title": "Redirect Old Date-Based Post URLs",
"description": "After switching from /2019/05/post-name/ style permalinks to plain post names, sends visitors and search engines from the old dated addresses to the right posts.",
"category": "redirects",
"tags": [
"permalinks",
"migration",
"404"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'template_redirect', function () {\n if ( ! is_404() ) {\n return;\n }\n\n $path = isset( $_SERVER['REQUEST_URI'] ) ? (string) wp_parse_url( wp_unslash( $_SERVER['REQUEST_URI'] ), PHP_URL_PATH ) : '';\n\n if ( ! preg_match( '#/\\d{4}/\\d{1,2}/(?:\\d{1,2}/)?([^/]+)/?$#', $path, $match ) ) {\n return;\n }\n\n $post = get_page_by_path( sanitize_title( rawurldecode( $match[1] ) ), OBJECT, 'post' );\n\n if ( ! $post || 'publish' !== $post->post_status ) {\n return;\n }\n\n $target = get_permalink( $post );\n\n if ( untrailingslashit( (string) wp_parse_url( $target, PHP_URL_PATH ) ) !== untrailingslashit( $path ) ) {\n wp_safe_redirect( $target, 301 );\n exit;\n }\n} );",
"requires": [],
"notes": "Only runs when the old address would otherwise be a 404."
},
{
"id": "woo-skip-cart-to-checkout",
"version": 1,
"title": "Skip the Cart and Go Straight to Checkout",
"description": "Sends shoppers who open the cart page directly to checkout whenever their cart has products, shortening the path to purchase.",
"category": "redirects",
"tags": [
"woocommerce",
"cart",
"checkout"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'template_redirect', function () {\n if ( ! function_exists( 'is_cart' ) || ! is_cart() || ! function_exists( 'WC' ) || ! WC()->cart || WC()->cart->is_empty() ) {\n return;\n }\n\n wp_safe_redirect( wc_get_checkout_url() );\n exit;\n} );",
"requires": [
"woocommerce"
],
"notes": "An empty cart still shows the cart page with its \"return to shop\" message."
},
{
"id": "woo-customers-to-shop-after-login",
"version": 1,
"title": "Send Customers to the Shop After Login",
"description": "Takes customers to the shop page after they log in or register through WooCommerce, instead of the My Account dashboard.",
"category": "redirects",
"tags": [
"woocommerce",
"login",
"redirect"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "$wpide_customer_redirect = function ( $redirect, $user = null ) {\n $user = $user instanceof WP_User ? $user : wp_get_current_user();\n\n if ( ! $user || user_can( $user, 'edit_posts' ) || user_can( $user, 'manage_woocommerce' ) ) {\n return $redirect;\n }\n\n $shop = wc_get_page_permalink( 'shop' );\n\n return $shop ? $shop : $redirect;\n};\n\nadd_filter( 'woocommerce_login_redirect', $wpide_customer_redirect, 20, 2 );\nadd_filter( 'woocommerce_registration_redirect', $wpide_customer_redirect, 20 );",
"requires": [
"woocommerce"
],
"notes": "Shop managers and administrators keep the default destination."
},
{
"id": "private-posts-redirect-to-login",
"version": 1,
"title": "Send Visitors to Login for Private Posts",
"description": "When a logged-out visitor opens a private post or page, they are sent to the login screen and back again, instead of seeing a \"not found\" error.",
"category": "redirects",
"tags": [
"private",
"login",
"404"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'template_redirect', function () {\n global $wp_query;\n\n if ( ! is_404() || is_user_logged_in() ) {\n return;\n }\n\n $id = (int) $wp_query->get( 'p' ) ? (int) $wp_query->get( 'p' ) : (int) $wp_query->get( 'page_id' );\n $post = $id ? get_post( $id ) : null;\n\n if ( ! $post ) {\n $name = $wp_query->get( 'pagename' ) ? $wp_query->get( 'pagename' ) : $wp_query->get( 'name' );\n $post = $name ? get_page_by_path( $name, OBJECT, array_values( get_post_types( array( 'public' => true ) ) ) ) : null;\n }\n\n if ( $post && 'private' === $post->post_status ) {\n wp_safe_redirect( wp_login_url( get_permalink( $post ) ) );\n exit;\n }\n} );",
"requires": [],
"notes": "After logging in, users who are not allowed to read private content still see the 404 page."
},
{
"id": "login-destination-by-role",
"version": 1,
"title": "Send Each Role to Its Own Page After Login",
"description": "Chooses where people land after logging in based on their role, for example editors to the posts list, customers to their account and subscribers to a members page.",
"category": "redirects",
"tags": [
"login",
"roles",
"redirect"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Role => destination. {admin} means the wp-admin address.\n$wpide_login_destinations = array(\n 'administrator' => '{admin}',\n 'editor' => '{admin}edit.php',\n 'author' => '{admin}edit.php',\n 'subscriber' => '/',\n);\n\nadd_filter( 'login_redirect', function ( $redirect_to, $requested, $user ) use ( $wpide_login_destinations ) {\n if ( ! $user instanceof WP_User ) {\n return $redirect_to;\n }\n\n if ( $requested && untrailingslashit( $requested ) !== untrailingslashit( admin_url() ) ) {\n return $redirect_to;\n }\n\n foreach ( (array) $user->roles as $role ) {\n if ( empty( $wpide_login_destinations[ $role ] ) ) {\n continue;\n }\n\n $target = $wpide_login_destinations[ $role ];\n\n return 0 === strpos( $target, '{admin}' ) ? admin_url( substr( $target, 7 ) ) : home_url( $target );\n }\n\n return $redirect_to;\n}, 20, 3 );",
"requires": [],
"notes": "Use {admin} at the start of a value for an admin page, or a path on your site. Explicit redirect_to links, such as from a protected page, are respected."
},
{
"id": "woo-require-login-for-shop",
"version": 1,
"title": "Require Login to Browse the Shop",
"description": "Sends visitors who are not logged in from the shop, product, cart and checkout pages to the My Account login form, for wholesale and members-only stores.",
"category": "redirects",
"tags": [
"woocommerce",
"b2b",
"login"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'template_redirect', function () {\n if ( is_user_logged_in() || ! function_exists( 'is_woocommerce' ) || is_account_page() ) {\n return;\n }\n\n if ( is_woocommerce() || is_cart() || is_checkout() ) {\n wp_safe_redirect( wc_get_page_permalink( 'myaccount' ) );\n exit;\n }\n} );\n\nadd_filter( 'woocommerce_login_redirect', function ( $redirect ) {\n $shop = wc_get_page_permalink( 'shop' );\n\n return $shop ? $shop : $redirect;\n}, 10 );",
"requires": [
"woocommerce"
],
"notes": "The My Account page stays open so customers can log in or register. After logging in, customers go back to the shop."
},
{
"id": "redirect-old-html-urls",
"version": 1,
"title": "Redirect Old .html Page Addresses",
"description": "Sends visitors from addresses of a previous static site, such as /about.html or /services/web.php, to the WordPress page with the same name.",
"category": "redirects",
"tags": [
"migration",
"html",
"404"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'template_redirect', function () {\n if ( ! is_404() ) {\n return;\n }\n\n $path = isset( $_SERVER['REQUEST_URI'] ) ? rawurldecode( (string) wp_parse_url( wp_unslash( $_SERVER['REQUEST_URI'] ), PHP_URL_PATH ) ) : '';\n\n if ( ! preg_match( '#^/?(.*?)([^/]+)\\.(?:html?|php|aspx?)$#i', $path, $match ) ) {\n return;\n }\n\n if ( 'index' === strtolower( $match[2] ) && '' === trim( $match[1], '/' ) ) {\n wp_safe_redirect( home_url( '/' ), 301 );\n exit;\n }\n\n $post = get_page_by_path( trim( $match[1] . $match[2], '/' ), OBJECT, array( 'page', 'post' ) );\n\n if ( ! $post ) {\n $post = get_page_by_path( sanitize_title( $match[2] ), OBJECT, array( 'page', 'post' ) );\n }\n\n if ( $post && 'publish' === $post->post_status ) {\n wp_safe_redirect( get_permalink( $post ), 301 );\n exit;\n }\n} );",
"requires": [],
"notes": "Only runs when the old address would otherwise be a 404. /index.html goes to the homepage."
},
{
"id": "redirect-category-to-page",
"version": 1,
"title": "Redirect a Category Archive to a Page",
"description": "Sends visitors from a category archive to a hand-built landing page, for example /category/news/ to your Newsroom page, while posts keep their category.",
"category": "redirects",
"tags": [
"categories",
"redirect",
"landing-page"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Category slug => page path, for example 'news' => '/newsroom/'.\n$wpide_category_redirects = array();\n\nadd_action( 'template_redirect', function () use ( $wpide_category_redirects ) {\n if ( ! is_category() || is_feed() ) {\n return;\n }\n\n $term = get_queried_object();\n\n if ( $term instanceof WP_Term && isset( $wpide_category_redirects[ $term->slug ] ) ) {\n wp_safe_redirect( home_url( $wpide_category_redirects[ $term->slug ] ), 301 );\n exit;\n }\n} );",
"requires": [],
"notes": "The list is empty by default. Map category slugs to paths of pages that exist on your site."
},
{
"id": "temporary-homepage-redirect",
"version": 1,
"title": "Temporary Homepage Redirect Between Two Dates",
"description": "Sends homepage visitors to a promotion or event page during a date range you set, such as a Black Friday sale, then switches back automatically.",
"category": "redirects",
"tags": [
"promotion",
"homepage",
"schedule"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "// Promotion period (YYYY-MM-DD HH:MM) and target page, for example '/black-friday/'.\n$wpide_promo_from = '';\n$wpide_promo_until = '';\n$wpide_promo_target = '';\n\nadd_action( 'template_redirect', function () use ( $wpide_promo_from, $wpide_promo_until, $wpide_promo_target ) {\n if ( ! is_front_page() || current_user_can( 'edit_posts' ) || '' === $wpide_promo_from || '' === $wpide_promo_until || '' === $wpide_promo_target ) {\n return;\n }\n\n $from = date_create( $wpide_promo_from, wp_timezone() );\n $until = date_create( $wpide_promo_until, wp_timezone() );\n\n if ( ! $from || ! $until || time() < $from->getTimestamp() || time() > $until->getTimestamp() ) {\n return;\n }\n\n $target = home_url( $wpide_promo_target );\n\n if ( untrailingslashit( $target ) !== untrailingslashit( home_url( '/' ) ) ) {\n wp_safe_redirect( $target, 302 );\n exit;\n }\n} );",
"requires": [],
"notes": "Fill in both dates and the target first; nothing happens while they are empty. Dates use the site time zone, editors are not redirected, and page caching may delay the switch."
},
{
"id": "analytics-consent-banner",
"version": 1,
"title": "Cookie Consent Banner With Google Consent Mode",
"description": "Shows a simple Accept / Reject cookie banner, sets Google Consent Mode v2 defaults to \"denied\" until the visitor accepts, and remembers the choice for six months.",
"category": "analytics",
"tags": [
"consent",
"cookies",
"gdpr",
"google"
],
"code_type": "php",
"insert_method": "auto",
"location": "frontend_only",
"insert_number": 1,
"code": "$wpide_consent = array(\n 'text' => 'We use cookies to understand how our site is used and to improve your experience.',\n 'policy_url' => get_privacy_policy_url(), // Link to your privacy policy.\n 'days' => 180, // How long the choice is remembered.\n);\n\nadd_action( 'wp_head', function () {\n ?>\n\n \n
';\n } );\n} );",
"requires": [],
"notes": "Read-only: nothing can be deleted or run from this screen."
},
{
"id": "dev-allow-json-csv-uploads",
"version": 1,
"title": "Allow JSON, CSV and Other Data File Uploads",
"description": "Lets administrators upload data files such as JSON, CSV, XML and Markdown to the Media Library, which WordPress blocks by default.",
"category": "developer",
"tags": [
"uploads",
"media",
"mime-types",
"files"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_filter( 'upload_mimes', function ( $mimes ) {\n if ( ! current_user_can( 'manage_options' ) ) {\n return $mimes;\n }\n\n // Extension => MIME type.\n $types = array(\n 'json' => 'application/json',\n 'csv' => 'text/csv',\n 'xml' => 'application/xml',\n 'md' => 'text/markdown',\n );\n\n return array_merge( $mimes, $types );\n} );\n\nadd_filter( 'wp_check_filetype_and_ext', function ( $data, $file, $filename, $mimes ) {\n if ( ! empty( $data['ext'] ) || ! current_user_can( 'manage_options' ) ) {\n return $data;\n }\n\n $check = wp_check_filetype( $filename, $mimes );\n\n if ( in_array( $check['ext'], array( 'json', 'csv', 'xml', 'md' ), true ) ) {\n $data['ext'] = $check['ext'];\n $data['type'] = $check['type'];\n }\n\n return $data;\n}, 10, 4 );",
"requires": [],
"notes": "Only users with the manage_options capability get the extra file types. Edit $types to add or remove extensions."
},
{
"id": "dev-site-options-page",
"version": 1,
"title": "Simple Site Details Settings Page",
"description": "Adds Settings > Site Details where you can store your phone number, address and opening hours once, then show them anywhere with [wpide_site_detail key=\"phone\"].",
"category": "developer",
"tags": [
"settings",
"options",
"shortcode",
"contact"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "$wpide_site_fields = array(\n 'phone' => 'Phone number',\n 'email' => 'Contact email',\n 'address' => 'Address',\n 'hours' => 'Opening hours',\n);\n\nadd_action( 'admin_init', function () use ( $wpide_site_fields ) {\n register_setting( 'wpide_site_details', 'wpide_site_details', array(\n 'type' => 'array',\n 'default' => array(),\n 'sanitize_callback' => function ( $input ) use ( $wpide_site_fields ) {\n $clean = array();\n\n foreach ( array_keys( $wpide_site_fields ) as $key ) {\n $clean[ $key ] = isset( $input[ $key ] ) ? sanitize_textarea_field( $input[ $key ] ) : '';\n }\n\n return $clean;\n },\n ) );\n} );\n\nadd_action( 'admin_menu', function () use ( $wpide_site_fields ) {\n add_options_page( 'Site Details', 'Site Details', 'manage_options', 'wpide-site-details', function () use ( $wpide_site_fields ) {\n $values = (array) get_option( 'wpide_site_details', array() );\n\n echo '
Site Details
';\n } );\n} );\n\nadd_shortcode( 'wpide_site_detail', function ( $atts ) {\n $atts = shortcode_atts( array( 'key' => '' ), $atts, 'wpide_site_detail' );\n $values = (array) get_option( 'wpide_site_details', array() );\n $value = isset( $values[ $atts['key'] ] ) ? $values[ $atts['key'] ] : '';\n\n return nl2br( esc_html( $value ) );\n} );",
"requires": [],
"notes": "Edit $fields to add more details. Values are stored in the wpide_site_details option."
},
{
"id": "dev-subtitle-meta-box",
"version": 1,
"title": "Subtitle Field for Posts",
"description": "Adds a \"Subtitle\" box to the post editor, saves it securely and provides a [wpide_subtitle] shortcode and a helper to display it in your theme.",
"category": "developer",
"tags": [
"custom-fields",
"meta-box",
"posts",
"shortcode"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'add_meta_boxes', function () {\n add_meta_box( 'wpide-subtitle', 'Subtitle', function ( $post ) {\n wp_nonce_field( 'wpide_subtitle_save', 'wpide_subtitle_nonce' );\n printf( '', esc_attr( get_post_meta( $post->ID, '_wpide_subtitle', true ) ) );\n }, 'post', 'side', 'high' );\n} );\n\nadd_action( 'save_post_post', function ( $post_id ) {\n if ( ! isset( $_POST['wpide_subtitle_nonce'] ) || ! wp_verify_nonce( sanitize_key( $_POST['wpide_subtitle_nonce'] ), 'wpide_subtitle_save' ) ) {\n return;\n }\n\n if ( ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) || ! current_user_can( 'edit_post', $post_id ) ) {\n return;\n }\n\n $value = isset( $_POST['wpide_subtitle'] ) ? sanitize_text_field( wp_unslash( $_POST['wpide_subtitle'] ) ) : '';\n\n if ( '' === $value ) {\n delete_post_meta( $post_id, '_wpide_subtitle' );\n } else {\n update_post_meta( $post_id, '_wpide_subtitle', $value );\n }\n} );\n\nadd_shortcode( 'wpide_subtitle', function () {\n $subtitle = get_post_meta( get_the_ID(), '_wpide_subtitle', true );\n\n return $subtitle ? '
' . esc_html( $subtitle ) . '
' : '';\n} );",
"requires": [],
"notes": "In a classic theme you can print it with echo esc_html( get_post_meta( get_the_ID(), '_wpide_subtitle', true ) );"
},
{
"id": "dev-register-post-status",
"version": 1,
"title": "Register an \"Archived\" Post Status",
"description": "Adds an \"Archived\" status for posts that should leave the site without being deleted, with its own filter link in the Posts list and a status choice in the editor.",
"category": "developer",
"tags": [
"post-status",
"workflow",
"content",
"admin"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'init', function () {\n register_post_status( 'wpide_archived', array(\n 'label' => 'Archived',\n 'public' => false,\n 'protected' => true,\n 'exclude_from_search' => true,\n 'show_in_admin_all_list' => false,\n 'show_in_admin_status_list' => true,\n /* translators: %s: number of posts */\n 'label_count' => _n_noop( 'Archived (%s)', 'Archived (%s)' ),\n ) );\n} );\n\nadd_action( 'admin_footer-edit.php', function () {\n global $post_type;\n\n if ( 'post' !== $post_type ) {\n return;\n }\n ?>\n\n post_status && ( ! isset( $_GET['post_status'] ) || 'wpide_archived' !== $_GET['post_status'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification\n $states['wpide_archived'] = 'Archived';\n }\n\n return $states;\n}, 10, 2 );",
"requires": [],
"notes": "Archived posts are not public. Set them via Quick Edit or the status dropdown in the block editor's summary panel."
},
{
"id": "dev-rest-cors-origins",
"version": 1,
"title": "Limit REST API CORS to Your Own Apps",
"description": "Replaces WordPress's permissive cross-origin (CORS) headers with an allow-list, so only the browser apps you name, such as a headless front end, can call the REST API with credentials.",
"category": "developer",
"tags": [
"rest-api",
"cors",
"headless",
"security"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'rest_api_init', function () {\n // Origins allowed to call the REST API from a browser.\n $allowed = array( 'https://app.example.com' );\n\n remove_filter( 'rest_pre_serve_request', 'rest_send_cors_headers' );\n\n add_filter( 'rest_pre_serve_request', function ( $served ) use ( $allowed ) {\n $origin = get_http_origin();\n\n if ( $origin && in_array( $origin, $allowed, true ) ) {\n header( 'Access-Control-Allow-Origin: ' . esc_url_raw( $origin ) );\n header( 'Access-Control-Allow-Methods: GET, POST, PUT, PATCH, DELETE, OPTIONS' );\n header( 'Access-Control-Allow-Credentials: true' );\n header( 'Access-Control-Allow-Headers: Authorization, Content-Type, X-WP-Nonce' );\n }\n\n header( 'Vary: Origin', false );\n\n return $served;\n } );\n}, 15 );",
"requires": [],
"notes": "List exact origins including the protocol and no trailing slash. Requests from other origins still work server to server, but browsers will block them."
},
{
"id": "dev-rest-max-per-page",
"version": 1,
"title": "Raise the REST API per_page Limit",
"description": "Lets REST API requests for posts and pages ask for more than 100 items at once, useful for exports and static site generators.",
"category": "developer",
"tags": [
"rest-api",
"api",
"pagination",
"headless"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "$wpide_rest_max = 500; // Highest per_page value allowed.\n\nforeach ( array( 'post', 'page' ) as $wpide_rest_type ) {\n add_filter( \"rest_{$wpide_rest_type}_collection_params\", function ( $params ) use ( $wpide_rest_max ) {\n if ( isset( $params['per_page'] ) ) {\n $params['per_page']['maximum'] = $wpide_rest_max;\n }\n\n return $params;\n } );\n}",
"requires": [],
"notes": "Large values make heavy queries; keep $max reasonable."
},
{
"id": "dev-daily-cron-task",
"version": 1,
"title": "Run a Daily Task With WP-Cron",
"description": "Schedules a custom task once a day and gives you a function to fill in, for example to clean up data or send a report. Includes the scheduling and the hook.",
"category": "developer",
"tags": [
"cron",
"scheduling",
"automation",
"tasks"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_action( 'init', function () {\n if ( ! wp_next_scheduled( 'wpide_daily_task' ) ) {\n // First run tomorrow at 03:00 site time.\n $first = new DateTime( 'tomorrow 03:00', wp_timezone() );\n wp_schedule_event( $first->getTimestamp(), 'daily', 'wpide_daily_task' );\n }\n} );\n\nadd_action( 'wpide_daily_task', function () {\n // Your daily code goes here. Example: log that the task ran.\n error_log( '[wpide_daily_task] ran at ' . wp_date( 'Y-m-d H:i:s' ) ); // phpcs:ignore WordPress.PHP.DevelopmentFunctions\n} );",
"requires": [],
"notes": "Put your code inside the wpide_daily_task callback. To stop the task after removing the snippet, run \"wp cron event delete wpide_daily_task\"."
},
{
"id": "dev-list-enqueued-assets",
"version": 1,
"title": "List Enqueued Scripts and Styles in the Page Source",
"description": "Prints an HTML comment at the bottom of each page, visible to administrators, listing every script and stylesheet handle loaded and its source, to find what to optimize.",
"category": "developer",
"tags": [
"debugging",
"scripts",
"styles",
"performance"
],
"code_type": "php",
"insert_method": "auto",
"location": "frontend_only",
"insert_number": 1,
"code": "add_action( 'wp_print_footer_scripts', function () {\n if ( ! current_user_can( 'manage_options' ) ) {\n return;\n }\n\n $lines = array( 'Enqueued assets' );\n\n foreach ( array( 'scripts' => wp_scripts(), 'styles' => wp_styles() ) as $type => $deps ) {\n $lines[] = strtoupper( $type ) . ':';\n\n foreach ( $deps->done as $handle ) {\n $src = isset( $deps->registered[ $handle ] ) ? (string) $deps->registered[ $handle ]->src : '';\n $lines[] = ' ' . $handle . ( $src ? ' => ' . $src : ' (inline/alias)' );\n }\n }\n\n echo \"\\n\\n\";\n}, 999 );",
"requires": [],
"notes": "View the page source and look for \"Enqueued assets\" near the end."
},
{
"id": "dev-log-redirects",
"version": 1,
"title": "Log Every Redirect With Its Source",
"description": "Writes each redirect WordPress makes to the error log, including the target, status code and the file that triggered it, to track down redirect loops.",
"category": "developer",
"tags": [
"debugging",
"redirects",
"logs"
],
"code_type": "php",
"insert_method": "auto",
"location": "everywhere",
"insert_number": 1,
"code": "add_filter( 'wp_redirect', function ( $location, $status ) {\n $source = '';\n\n foreach ( debug_backtrace( DEBUG_BACKTRACE_IGNORE_ARGS ) as $frame ) { // phpcs:ignore WordPress.PHP.DevelopmentFunctions\n if ( isset( $frame['file'] ) && false === strpos( $frame['file'], 'wp-includes' ) ) {\n $source = str_replace( ABSPATH, '', $frame['file'] ) . ':' . ( $frame['line'] ?? '?' );\n break;\n }\n }\n\n $from = isset( $_SERVER['REQUEST_URI'] ) ? esc_url_raw( wp_unslash( $_SERVER['REQUEST_URI'] ) ) : '';\n\n error_log( sprintf( '[redirect] %d %s -> %s (from %s)', $status, $from, $location, $source ) ); // phpcs:ignore WordPress.PHP.DevelopmentFunctions\n\n return $location;\n}, 999, 2 );",
"requires": [],
"notes": "Meant for troubleshooting; turn it off afterwards as it can write many log lines. Enable WP_DEBUG_LOG to read the entries."
},
{
"id": "dev-phpinfo-page",
"version": 1,
"title": "PHP Info Screen for Administrators",
"description": "Adds a Tools > PHP Info screen showing the full phpinfo() report (extensions, limits, configuration), handy when a host's control panel does not show it.",
"category": "developer",
"tags": [
"php",
"server",
"debugging",
"tools"
],
"code_type": "php",
"insert_method": "auto",
"location": "admin_only",
"insert_number": 1,
"code": "add_action( 'admin_menu', function () {\n add_management_page( 'PHP Info', 'PHP Info', 'manage_options', 'wpide-phpinfo', function () {\n if ( ! current_user_can( 'manage_options' ) ) {\n return;\n }\n\n ob_start();\n phpinfo(); // phpcs:ignore WordPress.PHP.DevelopmentFunctions\n $info = (string) ob_get_clean();\n\n // Keep only the body and scope the table styles to this screen.\n if ( preg_match( '#]*>(.*)