Skip to content

Big Trees CMS - WordPress headless CMS plugin and Next.js PWA trail guide

Notifications You must be signed in to change notification settings

sagedreams/bigtrees

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Big Trees CMS Project

WordPress headless CMS for Calaveras Big Trees State Park trail guide data.

Project Structure

bigtrees/
├── data/                    # Data files and source materials
│   ├── bigtrees_data.json  # Main data file (imported to WordPress)
│   ├── north_grove_trails.json
│   ├── North Grove Guide.pdf
│   └── pdf_full_text.txt
│
├── docs/                    # Documentation
│   ├── architecture-plan.md
│   ├── wordpress-setup-guide.md
│   ├── react-setup-guide.md
│   ├── post-meta-vs-acf-plan.md
│   ├── admin-editing-experience.md
│   └── ... (other docs)
│
├── scripts/                 # Python extraction scripts
│   ├── explore_pdf.py
│   ├── extract_trails.py
│   ├── find_trail_markers.py
│   └── check_stops_api.py
│
├── wordpress/               # WordPress plugin files
│   ├── bigtrees-cms-plugin.php
│   ├── bigtrees-acf-debug.php
│   └── wordpress-import.php
│
├── frontend/                # Frontend code (future React app)
│   └── types.ts             # TypeScript type definitions
│
├── venv/                    # Python virtual environment
├── requirements.txt         # Python dependencies
└── README.md               # This file

Quick Start

WordPress Setup

  1. Copy wordpress/ folder contents to wp-content/plugins/bigtrees-cms/
  2. Copy data/bigtrees_data.json to the plugin directory
  3. Activate the plugin in WordPress admin
  4. Go to Big Trees ImportImport Data

Development

Python Scripts

# Activate virtual environment
source venv/bin/activate

# Run extraction scripts
python scripts/extract_trails.py
python scripts/check_stops_api.py

WordPress Development

  • Plugin files are in wordpress/
  • The plugin will automatically find bigtrees_data.json in:
    1. Plugin directory (for deployment)
    2. ../data/ folder (for development)
    3. Theme directory (fallback)

Documentation

  • Setup Guide: docs/wordpress-setup-guide.md
  • Architecture: docs/architecture-plan.md
  • Quick Reference: docs/QUICK-START.md
  • API Review: docs/api-review-summary.md

Deployment Notes

When deploying to WordPress:

  • All files in wordpress/ should be in the plugin directory
  • bigtrees_data.json should be in the plugin directory
  • The plugin will work with files in the plugin directory

For development:

  • Files are organized in folders
  • Plugin automatically finds files in parent data/ folder

About

Big Trees CMS - WordPress headless CMS plugin and Next.js PWA trail guide

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors