Show Guide on Specific Page
Learn how to display your GuidePlugin guides on any page using shortcodes.
GuidePlugin offers the ability to place a guide anywhere on your page using a simple shortcode. This tutorial shows you how to display your created guides on specific pages.
Shortcode Overview
Method | Code | Use Case |
---|---|---|
Basic Shortcode | [guideplugin_guide id="24"] | Display guide on any page |
Page Editor | Insert via WordPress editor | Quick page embedding |
Template Code | PHP integration | Theme-level implementation |
Displaying Your Guide
Find Your Guide ID
First, you need to identify the ID of the guide you want to display:
- Go to GuidePlugin > Guides in WordPress admin
- Find your guide in the list
- Note the ID number (displayed in the guide list)
Use the Shortcode
The shortcode format is:
[guideplugin_guide id="{guide_id}"]
Replace {guide_id}
with your actual guide ID. For example:
[guideplugin_guide id="24"]
Add to Your Page
Place the shortcode in any of these locations:
WordPress Editor:
- Add to page content where you want the guide to appear
- Works in posts, pages, and custom post types
- Compatible with both Classic and Block editors
Widget Areas:
- Add to sidebars or footer areas
- Use text widget to insert shortcode
Shortcode Implementation
Basic Usage
The most common implementation is placing the shortcode directly in your page content:
Location | Method | Code |
---|---|---|
Page Content | Direct insertion | [guideplugin_guide id="24"] |
Post Content | Direct insertion | [guideplugin_guide id="24"] |
Text Widget | Widget content | [guideplugin_guide id="24"] |
WordPress Editor Integration
Classic Editor:
- Edit your page/post
- Position cursor where guide should appear
- Type or paste the shortcode
- Save/update the page
Block Editor (Gutenberg):
- Add a "Shortcode" block
- Enter your guideplugin_guide shortcode
- Preview to verify appearance
- Publish/update the page
Shortcode Processing: WordPress automatically processes the shortcode when the page loads, replacing it with your complete guide interface.
Finding Guide IDs
Method | Location | Steps |
---|---|---|
Admin List | GuidePlugin > Guides | ID shown in guide list table |
Edit Page | Individual guide settings | ID visible in URL or page title |
Database | WordPress admin area | Check guide management interface |
Placement Best Practices
Page Type | Recommended Placement | Why |
---|---|---|
Landing Pages | Above the fold, centered | Maximum visibility and engagement |
Product Pages | Below main description | Contextual filtering for related items |
Category Pages | Top of content area | Help users narrow down selections |
Dedicated Filter Pages | Main content area | Primary page purpose |
Common Implementation Examples
Product Finder Page
<h1>Find Your Perfect Product</h1>
<p>Use our guide to find exactly what you're looking for:</p>
[guideplugin_guide id="15"]
<p>Still have questions? Contact our support team.</p>
Real Estate Search
<h2>Property Search</h2>
<p>Filter properties by your preferences:</p>
[guideplugin_guide id="8"]
Service Selection
<h1>Choose the Right Service</h1>
<p>Answer a few questions to find the perfect service package:</p>
[guideplugin_guide id="12"]
Troubleshooting Display Issues
Problem | Symptoms | Solutions |
---|---|---|
Guide Not Showing | Shortcode appears as text | Verify guide ID is correct Check guide is published Ensure plugin is active |
Incorrect Guide | Wrong guide displays | Double-check guide ID number Verify ID matches intended guide |
Styling Issues | Guide appears but looks wrong | Check theme compatibility Review page layout settings Consider design adjustments |
Advanced Integration
For developers integrating guides into themes:
// Display guide programmatically
echo do_shortcode('[guideplugin_guide id="24"]');
// Conditional guide display
if (is_page('products')) {
echo do_shortcode('[guideplugin_guide id="15"]');
}
Testing: Always preview your page after adding the shortcode to ensure the guide displays correctly and fits well with your page layout.
Next Steps
Once your guide is displaying on your page:
Action | Purpose | Reference |
---|---|---|
Test User Experience | Verify guide works as expected | Getting Started → |
Customize Appearance | Match your site design | Designs Documentation → |
Monitor Performance | Ensure fast loading | Indexing Guide → |