🌱 Farmers Bounty – Admin Feature Shortcodes

Current Version: 3.1.1

📌 Overview

Farmers Bounty 3.1 provides 10 powerful shortcodes that allow you to embed full admin features directly into WordPress Pages and Posts. These shortcodes provide the complete functionality of the admin interface in a frontend context, perfect for creating custom garden management portals.

✨ What’s New in 3.1: Enhanced AI capabilities, persona-based customization, native plant tracking, pollinator support, comprehensive analytics, and desktop app sync!

🌦️ Weather Integration: The dashboard shortcode displays comprehensive weather data including station location, elevation, cardinal wind directions, UV index, solar radiation, dew point, and pressure in both imperial and metric units.

Requirements

User Role: Editor or Administrator
Permissions: edit_posts capability required
Plugin Version: Farmers Bounty 3.1.1 or higher
Users without proper permissions will see a notice message

🆕 What’s New in Version 3.1

Admin shortcodes now include enhanced features from v3.1 updates:

AI-Powered Recommendations: Dashboard shows Claude AI-generated personalized tips
Persona System: Features adapt based on user’s gardening persona
Native Plants: Plant manager includes native plant suggestions
Pollinator Tracking: Dashboard shows pollinator-friendly plant count
Water Management: Smart watering recommendations in dashboard
Climate Intelligence: Frost alerts, heat warnings, GDD tracking
Desktop Sync: Data syncs with macOS app (if configured)
Enhanced Analytics: More detailed charts and year-over-year comparisons

Available Shortcodes

1. 📊 Dashboard

You need Editor permissions to access the dashboard.

Description: Full garden dashboard with enhanced weather data, plant status, recommendations, and quick stats.

Features:

Enhanced weather widget showing station name, elevation, cardinal wind directions
Complete weather metrics (temperature, feels-like, UV index, dew point, pressure, solar radiation)
Plant status overview with health indicators
Harvest summary and upcoming harvests
AI-powered personalized recommendations
Quick action buttons for common tasks
Frost alerts and climate warnings

Use Case: Create a dedicated “My Garden” page for gardeners to see everything at a glance.

2. 🌿 Plants Manager

You need Editor permissions to manage plants.

Description: Complete plant management interface – add, edit, delete plants, view detailed profiles, record harvests, track care activities.

Features:

Search from comprehensive plant database (10,000+ species)
Plant cards with photos and status indicators
Detailed plant profiles with care requirements
Care tracking (watering, fertilizing, maintenance)
Harvest recording and yield tracking
Filter by type, location, or status

Use Case: Main plant tracking page where gardeners manage their entire collection.

3. 🌱 Seed Inventory

You need Editor permissions to access seed inventory.

Description: Seed inventory management system – track seeds, purchase dates, viability, germination rates, and planting schedules.

Features:

Track seed packets with photos
Viability date tracking and alerts
Germination testing records
Planting schedule generator
Source and cost tracking
Quantity management

Use Case: Dedicated seed catalog page for planning future plantings and managing inventory.

4. 📝 Season Learnings

You need Editor permissions to access season learnings.

Description: Record and review what worked, what didn’t, and lessons learned each season.

Features:

Document successes and failures
Link learnings to specific plants
Categorize by type (success, challenge, discovery)
Season summaries with AI insights
Year-over-year comparison
Export seasonal reports

Use Case: Garden journal page for documenting seasonal observations and continuous improvement.

5. 🔄 Succession Planting

You need Editor permissions to access succession planting.

Description: Plan and track succession plantings for continuous harvests throughout the season.

Features:

Time-based succession scheduling
Harvest-based succession triggers
Variety-based succession plans
Automated planting reminders
Gap identification in harvest timeline
Season extension planning

Use Case: Planting schedule page for coordinating staggered plantings and continuous production.

6. 📍 Garden Locations

You need Editor permissions to manage garden locations.

Description: Manage different garden areas, beds, and planting zones with detailed environmental conditions.

Features:

Track multiple location types (in-ground, raised bed, container, grow bag)
Record sunlight exposure and soil conditions
Dimension and capacity tracking
Infrastructure notes (irrigation, trellises)
Location photos and maps
Crop rotation planning by location

Use Case: Site management page for organizing garden layout and tracking microclimate zones.

7. 📈 Analytics

You need Editor permissions to view analytics.

Description: Comprehensive analytics dashboard with harvest data, success rates, trends, and performance insights.

Features:

Plant performance metrics
Harvest yield tracking and analysis
Space utilization efficiency
Cost per pound calculations
Seasonal comparisons and trends
Custom reports generation

Use Case: Data insights page for reviewing garden performance and making data-driven decisions.

8. 📅 Planting Calendar

You need Editor permissions to access the calendar.

Description: Visual calendar for planning planting dates, harvest windows, and maintenance tasks.

Features:

Month, timeline, and list views
Color-coded event types
Auto-generated events based on plant data
Weather-based event suggestions
Recurring task management
Export to Google Calendar or Todoist

Use Case: Scheduling page for coordinating all garden activities and never missing important dates.

9. 📥 CSV Import

You need Editor permissions to import CSV files.

Description: Import plant data from CSV files to quickly populate your garden.

Features:

CSV template download
Field mapping interface
Preview before import
Bulk plant import
Error handling and validation
Import history and logs

Use Case: Data migration page for users transitioning from spreadsheets or other gardening tools.

10. 💾 Backup & Restore

You need Editor permissions to backup and restore data.

Description: Export your garden data as backup files and restore from previous backups.

Features:

Full backup (all data + photos)
Data-only backup (smaller file size)
Selective backup (choose what to include)
Restore with merge or replace options
Scheduled automatic backups
Backup history and management

Use Case: Data management page for safeguarding garden records and disaster recovery.

Usage Examples

Single Feature Page

Create a dedicated page for each feature:

Simple Page Example

You need Editor permissions to access the dashboard.

Combined Garden Portal

Create a comprehensive garden management page:

Multi-Feature Page

You need Editor permissions to access the dashboard.

You need Editor permissions to access the calendar.

You need Editor permissions to manage plants.

Dedicated Feature Pages

Page 1: “My Garden” → You need Editor permissions to access the dashboard.
Page 2: “My Plants” → You need Editor permissions to manage plants.
Page 3: “Seed Collection” → You need Editor permissions to access seed inventory.
Page 4: “Garden Journal” → You need Editor permissions to access season learnings.
Page 5: “Planting Schedule” → You need Editor permissions to access the calendar.
Page 6: “Garden Analytics” → You need Editor permissions to view analytics.

Advanced Multi-Page Setup

Complete Garden Management Portal (6 Pages)

Page: "Dashboard"
You need Editor permissions to access the dashboard.

Page: "Plant Manager"  
You need Editor permissions to manage plants.

Page: "Calendar & Planning"
You need Editor permissions to access the calendar.
You need Editor permissions to access succession planting.

Page: "Seed Inventory"
You need Editor permissions to access seed inventory.

Page: "Analytics & Insights"
You need Editor permissions to view analytics.
You need Editor permissions to access season learnings.

Page: "Data Management"
You need Editor permissions to manage garden locations.
You need Editor permissions to import CSV files.
You need Editor permissions to backup and restore data.

Key Features

🔒 Permission-Based Access

Editor & Admin only
Friendly error messages
Secure capability checks

⚡ Full Functionality

Complete admin interface
All AJAX handlers work
Forms, tables, modals

🎨 Beautiful Styling

Garden-themed design
Mobile responsive
Dark mode support

🚀 Auto Asset Loading

Detects shortcodes
Loads CSS/JS automatically
No manual setup

Quick Reference Table

Shortcode	Purpose	Editor Access
`You need Editor permissions to access the dashboard.`	Full garden dashboard with weather and AI recommendations	✓ Yes
`You need Editor permissions to manage plants.`	Plant management interface with database search	✓ Yes
`You need Editor permissions to access seed inventory.`	Seed inventory manager with viability tracking	✓ Yes
`You need Editor permissions to access season learnings.`	Season learnings tracker with AI insights	✓ Yes
`You need Editor permissions to access succession planting.`	Succession planting planner for continuous harvest	✓ Yes
`You need Editor permissions to manage garden locations.`	Garden locations manager with microclimate tracking	✓ Yes
`You need Editor permissions to view analytics.`	Garden analytics dashboard with performance metrics	✓ Yes
`You need Editor permissions to access the calendar.`	Planting calendar with export to Google Calendar/Todoist	✓ Yes
`You need Editor permissions to import CSV files.`	CSV import tool with field mapping	✓ Yes
`You need Editor permissions to backup and restore data.`	Backup and restore data with scheduling	✓ Yes

Security & Permissions

🔐 User Capabilities

Editors & Administrators: Full access to all admin shortcodes
Authors & Contributors: See permission denied message (“You need Editor permissions…”)
Subscribers & Visitors: See permission denied message
Capability Check: All shortcodes verify edit_posts capability

🛡️ Data Privacy & Security

Users can only see and edit their own garden data
Multi-user support with complete data separation
All AJAX requests are nonce-protected
Sanitization and validation on all inputs
SQL injection prevention with prepared statements
XSS protection with proper escaping

Troubleshooting

Shortcode Not Working

Check User Role: Log in as Editor or Administrator
Verify Shortcode: Ensure shortcode is spelled correctly (use fb_ prefix)
Check Permissions: Verify user has edit_posts capability
Database Tables: Verify tables exist at Farmers Bounty → Database Setup
Check Console: Look for JavaScript errors in browser console (F12)

Styling Issues

Theme Conflicts: Some themes may override plugin styles
Add Custom CSS: Use Appearance → Customize → Additional CSS to fix conflicts
Disable Conflicting Plugins: Temporarily disable other plugins to identify conflicts
Clear Cache: Clear browser cache and any WordPress caching plugins

Data Not Displaying

Database Tables: Visit Farmers Bounty → Database Setup to verify tables exist
Add Data: Ensure you’ve added plants/seeds/locations first
Check Browser Console: Look for AJAX errors (F12 → Console tab)
API Keys: Verify API keys are configured in Settings if using AI features
Permissions: Verify database write permissions are correct

AJAX Not Working

Check admin-ajax.php: Verify URL is accessible
Review Error Logs: Check Farmers Bounty → Diagnostics
Disable Security Plugins: May block AJAX requests
Check Nonces: Ensure nonce generation is working

Best Practices

📄 Page Organization

Dashboard landing page
Separate pages for major features
Clear navigation menu
Breadcrumb navigation
Consistent page titles

👤 User Experience

Mobile-friendly testing
Descriptive page titles
Logical page order
Help text on each page
Quick links between features

💾 Data Management

Weekly automated backups
External CSV exports
Season archives
Before-update backups
Test restores periodically

🎨 Design Consistency

Match your theme colors
Consistent button styles
Professional layout
Clear visual hierarchy
Accessible design

Complete Garden Portal Setup Guide

🏡 Creating a Professional Garden Management Portal

Here’s a recommended structure for building a complete garden management experience using admin shortcodes:

Step 1: Create Your Pages

Recommended Page Structure

1. Garden Home (Dashboard)
   - Shortcode: You need Editor permissions to access the dashboard.
   - Slug: /garden/
   
2. My Plants
   - Shortcode: You need Editor permissions to manage plants.
   - Slug: /garden/plants/
   
3. Garden Calendar
   - Shortcode: You need Editor permissions to access the calendar.
   - Slug: /garden/calendar/
   
4. Seed Collection
   - Shortcode: You need Editor permissions to access seed inventory.
   - Slug: /garden/seeds/
   
5. Planting Plans
   - Shortcode: You need Editor permissions to access succession planting.
   - Slug: /garden/succession/
   
6. Garden Locations
   - Shortcode: You need Editor permissions to manage garden locations.
   - Slug: /garden/locations/
   
7. Garden Analytics
   - Shortcode: You need Editor permissions to view analytics.
   - Slug: /garden/analytics/
   
8. Garden Journal
   - Shortcode: You need Editor permissions to access season learnings.
   - Slug: /garden/journal/
   
9. Import Data
   - Shortcode: You need Editor permissions to import CSV files.
   - Slug: /garden/import/
   
10. Backup Data
    - Shortcode: You need Editor permissions to backup and restore data.
    - Slug: /garden/backup/

Step 2: Create Navigation Menu

Menu Structure in WordPress

Garden Menu:
├── 🏡 Garden Home
├── My Garden
│   ├── 🌿 My Plants
│   ├── 📅 Calendar
│   └── 📍 Locations
├── Planning
│   ├── 🌱 Seeds
│   ├── 🔄 Succession
│   └── 📊 Analytics
└── Data
    ├── 📝 Journal
    ├── 📥 Import
    └── 💾 Backup

Step 3: Add Navigation to Pages

Add this navigation HTML above each shortcode:

Page Header Template

<div class="garden-portal-nav">
  <a href="/garden/">🏡 Home</a> |
  <a href="/garden/plants/">🌿 Plants</a> |
  <a href="/garden/calendar/">📅 Calendar</a> |
  <a href="/garden/seeds/">🌱 Seeds</a> |
  <a href="/garden/analytics/">📊 Analytics</a> |
  <a href="/garden/backup/">💾 Backup</a>
</div>

<!-- Add your shortcode below -->
You need Editor permissions to access the dashboard.

Step 4: Add Custom CSS (Optional)

Example Custom CSS (Appearance → Customize → Additional CSS)

.garden-portal-nav {
    background: #f0fff4;
    border: 2px solid #48bb78;
    border-radius: 8px;
    padding: 15px;
    margin-bottom: 30px;
    text-align: center;
}

.garden-portal-nav a {
    color: #276749;
    text-decoration: none;
    padding: 8px 15px;
    margin: 0 5px;
    font-weight: 600;
}

.garden-portal-nav a:hover {
    color: #48bb78;
    text-decoration: underline;
}

/* Responsive navigation */
@media (max-width: 768px) {
    .garden-portal-nav {
        font-size: 0.9em;
    }
    .garden-portal-nav a {
        display: inline-block;
        margin: 5px 2px;
    }
}

💡 Advanced Integration Tips

Create a Menu: Build a custom menu linking to all your shortcode pages
Use Page Templates: Create custom page templates for better integration
Combine Features: Group related shortcodes on a single page (e.g., calendar + succession)
Mobile Testing: Always test on mobile devices – gardeners often use phones in the garden
Performance: Don’t put all 10 shortcodes on one page – it will slow loading
Permissions: Consider creating Editor accounts for family members who help garden
Integration: Link to external calendars (Google, Todoist) from calendar page
Documentation: Add help text above shortcodes to guide users
Backups: Always create backup before major data imports or changes
API Keys: Configure Claude AI for enhanced recommendations and plant diagnosis
Desktop Sync: Set up WordPress → Desktop sync for offline access
Persona System: Users can select their gardening persona to customize their experience

🌱 Farmers Bounty v3.1.1 • IT Influentials • February 2026
User Guide • Documentation Export