Backyard Gardner User Guide

Backyard Gardener v3.0.0 – Complete User Guide v3.0.0 STABLE

Version: 3.0.0
Last Updated: January 12, 2026
Status: Stable Production Release ⭐

Complete documentation for using the Backyard Gardener WordPress plugin – your complete garden management solution!

Introduction

Backyard Gardener is a comprehensive WordPress plugin designed to help gardeners plan, track, and optimize their gardens with intelligent features, real-time weather data, and Atlanta-specific guidance.

Who Is This For?

  • Home Gardeners – Track plants, harvests, and learnings
  • Serious Gardeners – Advanced analytics and planning tools
  • Atlanta Gardeners – Zone 7b optimized with local pest/disease data
  • Beginners – Easy-to-use interface with expert guidance
  • Experienced Gardeners – Sophisticated tracking and rotation planning

What Makes v3.0.0 Special?

Version 3.0.0 represents a major milestone – a stable, production-ready release with:

  • ✅ 25+ Production-Ready Features – Complete garden management suite
  • ✅ Stable Foundation – Long-term support commitment
  • ✅ Enhanced Cleanup System – No more orphaned data issues
  • ✅ Complete Documentation – 8,500+ lines of guides
  • ✅ Professional Quality – WordPress standards compliant
  • ✅ Backward Compatible – Seamless upgrades from v1.x and v2.0

What’s New in v3.0.0

Major Version Release

v3.0.0 is a major version release signifying production maturity and long-term stability.

🧹 NEW: Enhanced Cleanup System

Problem Solved: Previous installations were not properly unregistering in WordPress, leaving orphaned data.

Three-Tier Cleanup System:

1. Automatic Prior Installation Cleanup (NEW!)

  • When: During plugin activation
  • What: Detects incomplete prior uninstalls and automatically cleans up
  • Removes: Orphaned tables, leftover options, stale transients
  • Result: Clean slate for fresh installations

2. Enhanced Deactivation Cleanup

  • When: Plugin deactivation
  • What: Clears transients, removes cron events, flushes rewrite rules
  • Result: No stale cached data or orphaned scheduled tasks

3. Complete Uninstallation

  • When: Plugin deletion via WordPress admin
  • What: Removes all 11 database tables, options, transients, user meta, cron events
  • Safety: Optional data preservation setting
  • Result: Complete cleanup with no traces left behind

Multisite Support: All cleanup functions work seamlessly on WordPress multisite installations.

🌟 Complete Feature Set

All features from v2.0.0 are included and stable:

Weather Integration (100% API Capture)

  • Geographic data (latitude, longitude, elevation, station name)
  • Separate heat index and wind chill
  • Cardinal wind directions (N, SE, SW, etc.)
  • Pressure in imperial & metric units
  • UTC timestamps for better time zone handling
  • Enhanced shortcodes with three detail levels

Plant Management

  • Seed to harvest tracking
  • Multiple planter types (in-ground, raised bed, pot, grow bag, hanging basket)
  • Quality ratings for harvests
  • CSV import/export
  • Comprehensive plant profiles

Planning Tools

  • Succession planting scheduler
  • Crop rotation planning (9 plant families)
  • Planting calculator with personalized dates
  • Growing Degree Days (GDD) tracking
  • Harvest predictions
  • Visual calendar view

Analytics Dashboard

  • Year-over-year comparisons
  • Harvest trends and patterns
  • Top performers identification
  • Visual charts and graphs
  • Success rate tracking

Knowledge Base

  • 35+ pest profiles with Atlanta-specific timing
  • 15+ disease profiles with humidity considerations
  • Harvest preservation guide (3,000+ lines)
  • Red clay soil strategies (2,500+ lines)
  • Transplanting guides
  • Companion planting recommendations

AI Features

  • Claude AI-powered chatbot
  • Context-aware gardening advice
  • Web search integration (Tavily)
  • Natural language queries
  • Problem diagnosis
  • Personalized growing tips

Data Management

  • Complete backup/restore system
  • CSV import (4 formats with auto-detection)
  • CSV export for all data
  • Automatic database migrations
  • Database health monitoring

Getting Started

Requirements

  • WordPress: Version 5.0 or higher (6.0+ recommended)
  • PHP: Version 7.4 or higher (8.0+ recommended)
  • MySQL: Version 5.7 or higher (8.0+ recommended)
  • Memory: 128 MB minimum (256 MB recommended)
  • User Role: Administrator (for setup and configuration)

Installation

New Installation

  1. Download backyard-gardener-v3.0.0.zip
  2. Go to WordPress Admin → Plugins → Add New
  3. Click “Upload Plugin”
  4. Choose the downloaded ZIP file
  5. Click “Install Now”
  6. Click “Activate Plugin”
  7. Navigate to Backyard Gardener in the admin menu
  8. Complete initial setup

Upgrading from v2.0.0

  1. Backup your data (recommended but not required)
  2. Go to Plugins → Installed Plugins
  3. Deactivate “Backyard Gardener”
  4. Upload and activate v3.0.0
  5. Automatic migration runs – no action needed
  6. Verify all data is intact
  7. Continue using normally

Upgrading from v1.x

Important: Backup your data before upgrading from v1.x!
  1. Backup your data (highly recommended)
  2. Go to Backyard Gardener → Backup & Restore
  3. Click “Create Backup” and download the file
  4. Deactivate current version
  5. Upload and activate v3.0.0
  6. Wait for automatic migration to complete (may take 30-60 seconds)
  7. Verify all data migrated correctly
  8. Check dashboard for any migration notices

Initial Setup

1. Configure Settings

Navigate to: Backyard Gardener → Settings

Required:

  • Garden Name – Give your garden a name (e.g., “My Backyard Garden”)
  • Garden Address – Enter your street address (auto-calculates coordinates)

Optional (but recommended for full functionality):

  • Weather Underground API Key – For real-time weather data
  • Weather Station ID – Your local PWS station (e.g., KGAATLAN1017)
  • Claude API Key – For AI chatbot functionality
  • Tavily API Key – For web search in chatbot
  • Google Maps API Key – For geocoding addresses
  • Perenual API Key – For comprehensive plant database

2. Set Up Garden Locations

Navigate to: Backyard Gardener → Garden Locations

Create locations for different areas of your garden:

Example Locations:

  • Front yard raised beds
  • Back yard in-ground garden
  • Side yard containers
  • Patio pots
  • Greenhouse

For each location, specify:

  • Sunlight Conditions – Direct, Indirect, or Shade
  • Sunlight Time of Day – Morning, Midday, Afternoon, All Day
  • Sunlight Hours – Less than 3, 3-5, 6-8, 8+ hours
  • Soil Type – Red clay, Amended, Sandy, Raised bed mix, etc.
  • Drainage – Good, Moderate, Poor
  • Microclimate Notes – Hot spots, cool areas, windy sections, etc.
  • Dimensions – Size of the area (optional)

3. Add Your First Plant

Navigate to: Backyard Gardener → My Plants

Click Add New Plant and fill in:

  • Plant Name – Common name (e.g., “Tomato”)
  • Variety – Specific variety (e.g., “Cherokee Purple”)
  • Planting Date – When you planted it
  • Garden Location – Select from your locations
  • Planter Type – In-ground, Raised bed, Pot, Grow bag, or Hanging basket
  • Maturity at Planting – Seed, Bulb, Seedling, Immature, or Mature
  • Seed Source – Select from seed inventory (if applicable)
  • Notes – Any additional information

Core Features

1. Plant Management

Navigate to: Backyard Gardener → My Plants

Track all your plants from seed to harvest with comprehensive information including planting dates, locations, planter types, and detailed notes. View plants in list or card format, filter by status and location, and quickly record harvests.

2. Seed Inventory

Navigate to: Backyard Gardener → Seeds

Organize all your seeds with purchase dates, expiration dates, sources, storage locations, and germination rates. Link seeds to plants when planting and track seed-to-harvest performance.

3. Season Learnings

Navigate to: Backyard Gardener → Learnings

Document observations, successes, challenges, and techniques. Create a personal garden journal that helps you improve year after year. Categories include Success, Challenge, Pest/Disease, Weather, Soil, and Technique.

4. Harvest Tracking

Navigate to: Backyard Gardener → My Plants → Record Harvest

Record detailed harvest information including date, quantity, unit, quality rating, and notes. View harvest analytics by plant, type, month, quality, and year-over-year comparisons.

Garden Planning

1. Succession Planting

Navigate to: Backyard Gardener → Succession Planting

Automate continuous harvests by scheduling plantings at regular intervals. Create plans for crops like lettuce, radishes, beans, and more. Visual timeline shows scheduled plantings and expected harvest windows.

2. Crop Rotation Planning

Navigate to: Backyard Gardener → My Plants → Rotation Check

Prevent disease and improve soil with intelligent crop rotation. System tracks 9 plant families and provides rotation recommendations based on 2-4 year cycles.

3. Planting Calculator

Navigate to: Backyard Gardener → Dashboard → Recommendations

Get personalized planting dates based on your location, historical weather, plant requirements, and your past success. See optimal dates, early windows, late windows, and frost risk assessments.

4. Garden Locations

Navigate to: Backyard Gardener → Garden Locations

Track microclimates and conditions for each garden area. Record sunlight, soil type, drainage, temperature patterns, wind exposure, and special conditions.

Analytics & Insights

Analytics Dashboard

Navigate to: Backyard Gardener → Analytics

Comprehensive analytics including year-over-year comparisons, harvest trends, learning insights, and top performers. Visual charts and graphs help you identify patterns and improve your gardening.

Growing Degree Days (GDD)

Navigate to: Dashboard → GDD Widget

Track plant development scientifically using heat accumulation. More accurate than calendar days, GDD accounts for temperature variations and provides better harvest predictions.

Heat Stress Monitoring

Navigate to: Dashboard → Heat Stress Widget

Protect plants during Atlanta summers with heat tolerance tracking for 15+ crops. Receive alerts and protection recommendations when temperatures approach critical thresholds.

Data Management

Backup & Restore

Navigate to: Backyard Gardener → Backup & Restore

Never lose your garden data! Create manual backups or configure automatic daily, weekly, or monthly backups. Restore data with safety features including preview and selective restore options.

CSV Import

Navigate to: Backyard Gardener → Import CSV

Bulk import data from spreadsheets with auto-detection of format, columns, and data types. Supports plants, seeds, harvests, and custom formats.

CSV Export

Navigate to: Backyard Gardener → My Plants → Export to CSV

Export data for backup, analysis in Excel/Google Sheets, sharing with others, or migration to another system.

Advanced Features

Enhanced Weather Integration ⭐ v3.0.0

100% Weather Underground API data capture (28 fields) including temperature, wind, humidity, precipitation, UV index, solar radiation, barometric pressure, and complete station information.

AI Chatbot

Shortcode: [bg_chatbot]

Get expert gardening advice powered by Claude AI! The chatbot knows your garden, locations, weather, knowledge base, and history. Ask natural language questions and get personalized, context-aware responses.

Harvest Predictions

Navigate to: Dashboard → Predictions

AI-powered harvest forecasting using days to maturity, GDD requirements, weather forecast, your history, and variety data. Confidence levels indicate prediction accuracy.

Companion Planting

Navigate to: My Plants → Add Plant → Companion Suggestions

Plant friends together for mutual benefit! System knows good companions, bad companions, and the reasons why they work (or don’t).

Knowledge Base

Access expert guidance on 35+ pests, 15+ diseases, harvest preservation methods (3,000+ lines), red clay soil strategies (2,500+ lines), and more.

Shortcodes

Embed garden data on your website!

Weather Widget

[bg_weather]                          // Standard view
[bg_weather details="minimal"]        // Compact view
[bg_weather details="full"]           // Complete weather data

My Plants

[bg_my_plants]
[bg_my_plants status="active" limit="10" location="Back Yard"]

Garden Summary

[bg_garden_summary]

Recommendations

[bg_recommendations]

Chatbot

[bg_chatbot]
[bg_chatbot height="600px" theme="light"]

See full documentation for complete shortcode list and parameters.

FAQ

General Questions

Q: Do I need API keys?
A: No, the plugin works without them. API keys enable advanced features like the chatbot, weather data, and plant database.

Q: Is my data private?
A: Yes! All data stays in your WordPress database. API calls are encrypted.

Q: Does it work outside Atlanta?
A: Yes! While optimized for Atlanta/Zone 7b, it works anywhere. Configure your location, zone, and weather station.

Q: What’s new in v3.0.0?
A: v3.0.0 is a major version release with enhanced cleanup system and production-ready status. All v2.0.0 features are included and stable.

Technical Questions

Q: How do I backup my data?
A: Go to Backyard Gardener → Backup & Restore → Create Backup. Download the JSON file and store it safely.

Q: Can I import from other garden apps?
A: Yes, via CSV import. Export from your other app to CSV format, then import here.

Q: What happens to my data if I uninstall?
A: By default, all data is completely removed. You can set an option to preserve data if desired.

Support

Getting Help

Documentation:

  • User Guide (this document)
  • Installation Guide
  • Quick Start Guide
  • Release Notes

In-Plugin Help:

  • Hover over (?) icons for tooltips
  • Use the AI chatbot for questions
  • Check Settings → Help tab

Community:

  • WordPress.org support forum
  • GitHub issues (for bugs)
  • Email: support@it-influentials.com

Version History

v3.0.0 (January 12, 2026) – Major Release ⭐

  • ✅ Enhanced Cleanup System – Three-tier cleanup prevents orphaned data
  • ✅ Production Maturity – Stable, long-term support commitment
  • ✅ Complete Feature Set – All 25+ features stable and tested
  • ✅ Comprehensive Documentation – 8,500+ lines of guides
  • ✅ Backward Compatible – Seamless upgrades from v1.x and v2.0

v2.0.0 (January 12, 2026)

  • Enhanced Weather Integration (100% API capture)
  • Seed Inventory, Season Learnings, Succession Planting
  • Analytics Dashboard, Planting Calculator, Crop Rotation
  • GDD Tracking, Heat Stress Alerts, Backup/Restore

v1.1.0 (January 10, 2026)

  • Chatbot integration, API integrations, Multi-tab UI

v1.0.0 (January 8, 2026)

  • Initial release

Thank you for using Backyard Gardener v3.0.0! 🌱

Your complete garden management solution – from seed to harvest and beyond.

Last Updated: January 12, 2026
Version: 3.0.0 (Stable Production Release)
Plugin URI: https://it-influentials.com/backyard-gardener
Support: support@it-influentials.com

“Growing gardens, growing knowledge, growing community.” 🌿

Privacy Policy Terms and Conditions Cookie Policy