Directory Structure
Scottsdale Mint uses the Roots.io Bedrock WordPress framework, which reorganizes the standard WordPress directory layout for improved security, maintainability, and environment separation.
Root Directory
scottsdalemint/ ← Repository root (NOT the web root)
├── AGENTS.md ← AI agent & developer reference (read this first)
├── auth.json ← Private Packagist auth (NEVER COMMIT)
├── bitbucket-pipelines.yml ← CI/CD pipeline
├── composer.json ← ALL plugins, WordPress core, and themes defined here
├── composer.lock ← Locked dependency versions
├── patches.lock.json ← Composer patch lock file
├── README.md ← Project README
├── UPDATE.md ← Update notes and changelog
├── wp-cli.yml ← WP-CLI path and URL configuration
├── ymir.yml ← Ymir (AWS Lambda) hosting configuration
├── .env ← Local secrets (NEVER COMMIT — in .gitignore)
├── .env.example ← Template for .env
├── config/
│ ├── application.php ← Main WordPress config (all env vars consumed here)
│ ├── class-config-helper.php ← Plugin disabler utility class
│ └── environments/
│ ├── development.php ← Development-specific overrides
│ ├── local.php ← Local/Herd-specific overrides
│ ├── staging.php ← Staging-specific overrides
│ └── production.php ← Production-specific overrides
├── docs/ ← This Docusaurus documentation site
├── nfusion/
│ └── live-price-chart/ ← NFusion spot price chart widget (standalone Webpack build)
├── patches/ ← Patch files applied to third-party plugins via Composer
│ ├── 0001-Dev-CryptoWoo-Disable-Requests.patch
│ ├── 0001-Dev-Walmart-patch-missing-required-properties.patch
│ ├── 2FA-fix-path-in-twilio.patch
│ ├── Kount-Remove-Unecessary-Logging.patch
│ └── [other patches]
├── scenario-testing/ ← Jest + Puppeteer end-to-end checkout tests
├── tools/
│ ├── db-sync/ ← Database sync tool (prod/staging → local)
│ ├── nfusion-import/ ← NFusion product catalog CSV import scripts
│ └── s3-sync/ ← S3 media file sync tools
├── vendor/ ← Composer PHP packages (DO NOT EDIT)
└── vendor-static/ ← Static vendor packages (Wonolog/Monolog)
web/ — The Web Root
The web/ directory is the document root that the web server points to. Only files inside web/ are publicly accessible.
web/
├── index.php ← WordPress bootstrap (standard)
├── wp-config.php ← Loads config/application.php; handles CloudFront/Cloudflare IP
├── robots.txt ← Search engine crawl rules
├── google0763189db8ee5157.html ← Google Search Console verification
├── wp/ ← WordPress core (DO NOT EDIT — Composer-managed)
│ ├── wp-admin/
│ ├── wp-includes/
│ └── [standard WP core files]
├── app/ ← Equivalent to wp-content/
│ ├── mu-plugins/ ← Must-use plugins (auto-loaded before all others)
│ ├── plugins/ ← All plugins (Composer-managed)
│ ├── themes/ ← All themes (Composer-managed)
│ └── uploads/ ← Media uploads (S3 in production via Ymir)
└── tools/ ← Web-accessible admin/developer tools
web/app/ — The WordPress Content Directory
This replaces the standard wp-content/ directory. The constant WP_CONTENT_DIR points here.
mu-plugins/ — Must-Use Plugins
Must-use plugins are automatically loaded on every request, before regular plugins. They cannot be deactivated through the WordPress admin.
mu-plugins/
├── a-suma-perfmatters-filters.php ← Overrides Perfmatters cache path
├── bedrock-plugin-disabler/ ← Allows disabling plugins via config (not DB)
├── disable-deprecation.php ← Suppresses deprecated feature notices
├── disable-woocommerce-block.php ← Disables WooCommerce block editor features
├── perfmatters_mu.php ← Perfmatters performance monitoring
└── wonolog.php ← Structured JSON logging setup (Wonolog + Monolog)
plugins/ — All Plugins
All plugins are installed via Composer. Key custom plugins:
plugins/
├── scottsdale-ach-gateway/ ← Custom ACH payment gateway (Plaid + iTransact)
├── suma-woo-emails/ ← Custom WooCommerce transaction emails
├── suma-woo-order-tracking/ ← Customer order tracking page
├── suma-patches/ ← Site-specific patches and environment overrides
├── suma-dealer-locator/ ← Google Maps dealer finder
├── suma-faqs/ ← FAQ management
├── sumatra-utilities/ ← Shared utility library (Rhino Group)
├── sumatra-logger/ ← Custom structured logging integration
├── wc-admin-precious-metals-data/ ← Admin analytics (ounces sold, daily report)
├── back-in-stock-notifications-for-klaviyo/ ← Klaviyo back-in-stock forms
├── reserved-stock-pro/ ← Inventory reservation during checkout
├── woo-custom-related-products/ ← Custom related product logic
└── [40+ third-party plugins]
themes/ — Themes
themes/
└── suma-elementor/ ← The only active theme (v2.3.0)
├── style.css ← Theme header declaration
├── functions.php ← Theme bootstrap
├── inc/ ← All PHP classes (50+ classes)
├── dist/ ← Compiled CSS and JS (from Webpack Mix)
├── src/ ← SCSS and JavaScript source files
├── template-parts/ ← Reusable PHP template fragments
├── woocommerce/ ← WooCommerce template overrides
├── cryptowoo/ ← CryptoWoo template overrides
└── suma-dealer-locator/ ← Dealer locator templates
The suma-elementor Theme inc/ Deep Dive
The theme's inc/ directory contains all PHP business logic:
inc/
├── class-theme.php — Main entrypoint, loads all classes
├── class-woocommerce.php — 760+ lines of WC hooks and filters
├── class-admin.php — WP admin customizations
├── class-frontend.php — Frontend scripts, head/body injection
├── class-customizer.php — WordPress Customizer integration
├── class-elementor.php — Elementor extension registration
├── class-elementor-widgets.php — Custom widget registration
├── class-user.php — User account / role management
├── class-post.php — Post type utilities
├── class-pricing.php — Global pricing manager
├── class-pricing-tools.php — Pricing calculation utilities
├── class-trends.php — Historical pricing trend data
├── class-medoo.php — Medoo database wrapper
├── class-klaviyo.php — Klaviyo API integration
├── class-yotpo.php — Yotpo reviews integration
├── class-settings.php — Theme settings/option keys
├── class-translations.php — Translation/i18n utilities
├── endpoints/ — REST API endpoint classes (18+ endpoints)
├── product/ — Product pricing, stock, visibility classes
├── checkout/ — Checkout customization + Kount Pre-Auth
├── order/ — Order handling classes
├── email/ — Email-related helpers
├── account/ — My Account page customizations
├── cart/ — Shopping cart logic
├── apps/ — Mobile app helpers
├── yith/ — YITH plugin integrations
├── tags/ — Custom Elementor dynamic tags
├── widgets/ — Custom Elementor widget classes
├── skins/ — Custom Elementor widget skin variations
├── traits/ — PHP traits reused across classes
└── integration/
├── class-algolia.php — Algolia CURL/referer configuration
├── class-translate-press.php — TranslatePress integration
├── class-kount-ens-endpoint.php — Kount fraud decision callback
└── class-walmart.php — Walmart Marketplace integration
Key Bedrock Conventions
| Standard WP Path | Bedrock Path | Notes |
|---|---|---|
/wp-content/ | /web/app/ | WP_CONTENT_DIR |
/wp-content/plugins/ | /web/app/plugins/ | Managed by Composer |
/wp-content/themes/ | /web/app/themes/ | Managed by Composer |
/wp-content/uploads/ | /web/app/uploads/ | S3 in production |
/wp-config.php | /web/wp-config.php | Loads config/application.php |
| WordPress core | /web/wp/ | Composer-managed, do NOT edit |
| Admin URL | /wp/wp-admin/ | Note the /wp/ prefix |
Adding New Files
| What | Where | How |
|---|---|---|
| New plugin | web/app/plugins/new-plugin/ | Add to composer.json, run composer require |
| New theme | web/app/themes/new-theme/ | Add to composer.json |
| WordPress core update | web/wp/ (auto) | Update version in composer.json, run composer update |
| New patch | patches/new-patch.patch | Add entry in composer.json under extra.patches |
| New MU plugin | web/app/mu-plugins/ | Create PHP file directly (no Composer entry needed) |
| New Elementor widget | web/app/themes/suma-elementor/inc/widgets/ | Create class file, register in class-elementor-widgets.php |
| New REST endpoint | web/app/themes/suma-elementor/inc/endpoints/ | Create class extending base, register in class-theme.php |