Updated short Keys

Here is your complete master cheat sheet for all the custom shortcodes we just built into your theme.

Because we built a Global Post Tracker into the background of your PHP, you never have to worry about the same post showing up twice. If a post appears in the top Hero Block, it will automatically be hidden from any Category or Sidebar blocks below it!

1. The Main Hero Block (Top of Homepage)

This is your massive, premium SEO block. It automatically pulls the 5 absolute newest published posts and creates the 1 Panoramic Feature + 4 Grid layout.

Basic Usage:

Plaintext

[nm_hero_block]

(No parameters needed. Drop this at the very top of your homepage, full-width).

2. The Category Block (Main Content Area)

This is your most powerful tool. It allows you to pull specific news by category, pin certain posts, and switch between standard grids and your brand-new Modern Magazine Layout.

Available Parameters:

• title: The heading text for the section (e.g., title="FIFA World Cup").
• cat_id: The numeric ID of the category (e.g., cat_id="5").
• layout: Choose between magazine (1 Large + 3 Side Cards) or grid (Standard 3-column row).
• count: How many posts to show. Use 4 for magazine, or 3/6 for grid.
• priority_posts: Comma-separated Post IDs to force to the front of this specific block.
• skip_cats: Comma-separated Category IDs to exclude.
• skip_posts: Comma-separated Post IDs to manually hide.

Example A: The Modern Magazine Layout (Highly Recommended)

This creates the beautiful layout with the massive 84-word excerpt on the left, and 3 smaller cards on the right.

Plaintext

[nm_category_block title="World Cup News" cat_id="5" layout="magazine" count="4"]

Example B: The Standard Grid Layout

Creates a standard row of 3 cards side-by-side.

Plaintext

[nm_category_block title="Premier League" cat_id="8" layout="grid" count="3"]

Example C: Pinning Specific Posts

Forces Post ID #105 and #212 to show up first in this block, regardless of when they were published.

Plaintext

[nm_category_block title="Featured Editorials" cat_id="12" priority_posts="105,212" layout="magazine" count="4"]

3. The Mini Sidebar Widget (Right Column)

These are perfectly designed for tight spaces, sidebars, or narrow columns. They create compact 3D pill-shaped cards or clean text lists.

Available Parameters:

• title: The heading for the widget box (e.g., title="Trending Now").
• count: Number of posts to display (default is 5).
• layout: Choose image_title (shows thumbnail + 3-line excerpt) or title_only (clean, scannable text list).
• type: Choose latest (newest posts) or viewed (most popular). (Note: ‘viewed’ requires a post views tracking plugin).

Example A: Standard Sidebar Cards with Images

Plaintext

[nm_mini_list type="latest" layout="image_title" count="5" title="Latest Updates"]

Example B: Trending Text-Only List

Creates a highly compact, lightning-fast text list. Great for “Most Read” sections.

Plaintext

[nm_mini_list type="viewed" layout="title_only" count="6" title="🔥 Trending Matches"]

🏗️ How to structure your page like a Pro:

If you are using the WordPress Block Editor (Gutenberg), you can build the ultimate news portal by arranging your blocks like this:

Row 1 (Full Width):

Plaintext

[nm_hero_block]

Row 2 (Split Columns – 70% Left / 30% Right Sidebar):

Inside the 70% Left Column:

Plaintext

[nm_category_block title="Football Fixtures" cat_id="10" layout="magazine" count="4"]

Inside the 30% Right Column:

Plaintext

[nm_mini_list type="viewed" layout="title_only" count="6" title="Most Read"]

How to use your 4 new Shortcodes:

Style 5: The “New York Times” Block (Solid Border, No Gradient) A very serious, heavy-hitting editorial look.

Plaintext

[nm_mini_list layout="text_border_left" count="5" title="Breaking News"]

Style 6: The Premium Soft Gradient A soft, elegant box that lights up into a bright blue gradient when the user hovers over it.

Plaintext

[nm_mini_list layout="text_gradient_bg" count="5" title="Featured Articles"]

Style 7: The Minimalist Dashed List (No Gradient) Very clean, uses a tiny dash instead of a bullet point. Great for high volumes of text.

Plaintext

[nm_mini_list layout="text_minimal_dash" count="6" title="Latest Headlines"]

Style 8: The Cyber/Sport Gradient Dot Minimalist white text box, but the bullet point is a glowing blue-to-cyan gradient circle.

Plaintext

[nm_mini_list layout="text_gradient_bullet" count="5" title="Match Updates"]