Skip to main content
What can we help you with?
< All Topics
Print

ADMIN-SHORTCODES.html Update Summary

Posted
Updated
ByPeter Westerman

ADMIN-SHORTCODES.html Update Summary

Changes Made – February 12, 2026

Updated ADMIN-SHORTCODES.html to reflect the current version of Farmers Bounty plugin (v3.1.1) with corrected shortcode prefixes and comprehensive feature descriptions.

Version Update

  • Old Version: 3.0.0
  • New Version: 3.1.1

Major Content Updates

1. Version and Overview Section

Updated from:

  • Version 3.0.0
  • Generic description

Updated to:

  • Version 3.1.1
  • Enhanced description highlighting v3.1 features:
  • AI capabilities
  • Persona-based customization
  • Native plant tracking
  • Pollinator support
  • Comprehensive analytics
  • Desktop app sync

2. Critical Fix: Shortcode Prefix Consistency

Fixed ALL inconsistent shortcode prefixes:

❌ Incorrect (Old):

  • [bg_dashboard]
  • [bg_analytics]
  • [bg_import_csv]
  • [bg_backup_restore]

✅ Correct (New):

  • You need Editor permissions to access the dashboard.
  • You need Editor permissions to view analytics.
  • You need Editor permissions to import CSV files.
  • You need Editor permissions to backup and restore data.

Note: ALL 10 admin shortcodes now consistently use fb_ prefix (Farmers Bounty), not mixed bg_/fb_ prefixes.

3. New Section: What’s New in Version 3.1

Added comprehensive callout box highlighting v3.1 enhancements:

  • AI-Powered Recommendations (Claude AI)
  • Persona System (9 gardening personas)
  • Native Plants (native plant suggestions)
  • Pollinator Tracking (pollinator-friendly plant count)
  • Water Management (smart watering recommendations)
  • Climate Intelligence (frost alerts, heat warnings, GDD)
  • Desktop Sync (macOS app synchronization)
  • Enhanced Analytics (detailed charts, year-over-year)

4. Enhanced Shortcode Descriptions

Added detailed feature lists for EACH shortcode:

Dashboard (

You need Editor permissions to access the dashboard.
):

  • Added 7 feature bullets including frost alerts and climate warnings

Plants Manager (

You need Editor permissions to manage plants.
):

  • Added 6 feature bullets including database search and care tracking

Seed Inventory (

You need Editor permissions to access seed inventory.
):

  • Added 6 feature bullets including viability tracking and germination testing

Season Learnings (

You need Editor permissions to access season learnings.
):

  • Added 6 feature bullets including AI insights and year-over-year comparison

Succession Planting (

You need Editor permissions to access succession planting.
):

  • Added 6 feature bullets including various succession methods

Garden Locations (

You need Editor permissions to manage garden locations.
):

  • Added 6 feature bullets including location types and crop rotation

Analytics (

You need Editor permissions to view analytics.
):

  • Added 6 feature bullets including custom reports and ROI calculations

Calendar (

You need Editor permissions to access the calendar.
):

  • Added 6 feature bullets including export integrations

CSV Import (

You need Editor permissions to import CSV files.
):

  • Added 6 feature bullets including field mapping and validation

Backup & Restore (

You need Editor permissions to backup and restore data.
):

  • Added 6 feature bullets including scheduled backups and restore options

5. Updated Quick Reference Table

Enhanced table descriptions:

  • Each shortcode now has detailed purpose description
  • Highlights key capabilities (AI, database search, integrations)
  • All shortcode prefixes corrected to fb_

6. Enhanced Security Section

Added 3 additional security points:

  • Capability check details
  • Sanitization and validation
  • SQL injection prevention with prepared statements
  • XSS protection with proper escaping

7. Expanded Troubleshooting Section

Added new troubleshooting category:

  • AJAX Not Working (4 steps)

Enhanced existing categories:

  • Database Tables verification step
  • API Keys troubleshooting
  • Database permissions check
  • Diagnostics page reference

Specific improvements:

  • Added F12 console instructions
  • Added Database Setup page references
  • Added Diagnostics page references
  • More detailed step-by-step solutions

8. Enhanced Usage Examples

Added new example:

  • Advanced Multi-Page Setup (6-page portal structure)

Updated existing examples:

  • Corrected [bg_dashboard] to
    You need Editor permissions to access the dashboard.
  • Added 2 more dedicated page examples (pages 5 & 6)

9. New Section: Complete Garden Portal Setup Guide

Added comprehensive 4-step setup guide:

Step 1: Create Your Pages

  • 10 recommended pages with shortcodes and slugs
  • Organized URL structure (/garden/*)

Step 2: Create Navigation Menu

  • Hierarchical menu structure
  • Organized by category (My Garden, Planning, Data)
  • Visual tree structure

Step 3: Add Navigation to Pages

  • HTML template for page navigation
  • Quick links between features
  • Example implementation

Step 4: Add Custom CSS

  • CSS template for navigation styling
  • Responsive design
  • Hover effects
  • Mobile optimization

10. Enhanced Best Practices

Added 4th category:

  • Design Consistency (5 tips)

Expanded existing categories:

  • Page Organization: +2 tips (breadcrumbs, consistent titles)
  • User Experience: +2 tips (help text, quick links)
  • Data Management: +2 tips (before-update backups, test restores)

11. Enhanced Advanced Tips

Added 2 new tips:

  • Desktop Sync setup recommendation
  • Persona System customization

Total tips increased from 10 to 12

12. Updated Footer

  • Version: 3.0.0 → 3.1.1
  • Date: January 2026 → February 2026
  • Added links to User Guide and Documentation Export

13. Requirements Section Update

Added:

  • Plugin Version requirement (3.1.1 or higher)

CSS Class Corrections

All CSS classes updated for consistency:

  • bg-admin-shortcodes → fb-admin-shortcodes
  • bg-info-box → fb-info-box
  • bg-warning-box → fb-warning-box
  • bg-shortcode-card → fb-shortcode-card
  • bg-code-example → fb-code-example
  • bg-feature-grid → fb-feature-grid
  • bg-feature-card → fb-feature-card
  • bg-comparison-table → fb-comparison-table
  • bg-badge → fb-badge

Content Statistics

Old Version:

  • Version 3.0.0
  • 10 shortcodes (4 with bg_ prefix, 6 with fb_ prefix – inconsistent)
  • Basic feature descriptions
  • 3 usage examples
  • 3 troubleshooting categories
  • 3 best practice categories
  • 10 advanced tips

New Version:

  • Version 3.1.1
  • 10 shortcodes (ALL with fb_ prefix – consistent)
  • Detailed feature bullets for each (6 per shortcode)
  • 5 usage examples
  • 4 troubleshooting categories
  • 4 best practice categories
  • 12 advanced tips
  • Complete portal setup guide (4 steps)

Key Improvements

  1. Consistency: ALL shortcodes now use fb_ prefix
  2. Completeness: Every shortcode has detailed feature list
  3. Version Accuracy: Reflects v3.1.1 capabilities
  4. Portal Guide: Complete setup instructions for building custom garden portal
  5. Enhanced Troubleshooting: More detailed problem-solving steps
  6. Better Organization: Clear hierarchical structure
  7. More Examples: 5 practical examples (up from 3)
  8. Navigation Templates: Ready-to-use HTML and CSS code
  9. Mobile Focus: Emphasis on mobile testing and responsive design
  10. Integration Info: Desktop sync, API setup, external calendar connections

Breaking Changes

Users following old documentation need to update shortcodes:

  • [bg_dashboard] →
    You need Editor permissions to access the dashboard.
     ✓ CRITICAL
  • [bg_analytics] →
    You need Editor permissions to view analytics.
     ✓ CRITICAL
  • [bg_import_csv] →
    You need Editor permissions to import CSV files.
     ✓ CRITICAL
  • [bg_backup_restore] →
    You need Editor permissions to backup and restore data.
     ✓ CRITICAL

Impact: Old shortcodes will NOT work – users must update to new prefix.

Testing Checklist

Before distribution, verify:

  • [x] All shortcode prefixes are fb_ (no bg_)
  • [x] Version number is 3.1.1
  • [x] All feature descriptions are accurate
  • [x] CSS class names use fb- prefix
  • [x] Examples show correct syntax
  • [x] Links work (User Guide, IT Influentials, Documentation)
  • [x] Portal setup guide is complete
  • [x] Navigation templates are ready-to-use

New Features Documented

Version 3.1 Capabilities:

  1. ✅ AI-powered recommendations (Claude API)
  2. ✅ Persona-based customization (9 personas)
  3. ✅ Native plant tracking
  4. ✅ Pollinator support
  5. ✅ Water management intelligence
  6. ✅ Climate intelligence (frost/heat alerts, GDD)
  7. ✅ Desktop app synchronization
  8. ✅ Enhanced analytics
  9. ✅ Export integrations (Google Calendar, Todoist)
  10. ✅ Comprehensive backup scheduling

File Structure

Location:


documentation/ADMIN-SHORTCODES.html

Can Be Used As:

  1. WordPress HTML Block: Copy and paste into HTML block on page
  2. Reference Document: Keep as HTML file for distribution
  3. Embedded Documentation: Link from plugin pages
  4. Training Material: For teaching users how to use shortcodes

Usage Recommendations

For Site Owners:

  • Create one page per shortcode for best performance
  • Use portal setup guide to create complete system
  • Test all pages on mobile devices
  • Configure API keys for full functionality

For Developers:

  • All shortcodes are in /includes/class-admin-shortcodes.php
  • Frontend assets load automatically when shortcodes detected
  • AJAX handlers work without additional configuration
  • Security handled by plugin (nonces, capability checks)

For Support Teams:

  • Reference this document when helping users
  • Check shortcode prefix (fb_ not bg_)
  • Verify Editor permissions
  • Point to troubleshooting section
Table of Contents
Privacy Policy Terms and Conditions Cookie Policy