Gold Cart - Premium Membership Plugin for WooCommerce

Overview

Gold Cart is a WordPress/WooCommerce plugin that creates an automatic premium membership system based on completed account information. Users become "Gold Cart" members when they have all required fields filled in their account.

Features

🌟 Automatic Premium Membership

• Users automatically become Gold Cart members when profile is complete
• Required fields: First Name, Last Name, Email, Phone (10 digits)
• Real-time status updates

🛍️ Premium Products

• Mark products as Gold Cart exclusive
• Products hidden from non-members
• Quick edit and bulk actions support
• Direct access protection with custom messages

📱 Account Enhancement

• Phone field added to account form
• US phone validation (10 digits)
• Automatic formatting

💬 Customizable Messages

• 6 different message scenarios
• Admin-configurable through UI
• HTML support for rich formatting

👤 Account Dashboard Indicator

• Visual status display on account page
• Gold star for premium members
• Call-to-action for standard members

🛠️ Admin Features

• Dedicated admin menu
• Member statistics
• Manual status override
• Data cleanup tool

Requirements

• WordPress 5.0 or higher
• WooCommerce 3.0 or higher
• PHP 7.4 or higher

Installation

1. Upload the gold-cart folder to /wp-content/plugins/
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Configure messages in Gold Cart → Messages
4. Start marking products as Gold Cart exclusive

Usage

For Store Owners

1. Mark Products as Premium

   • Edit any product
   • Check "Gold Cart Members Only" in Gold Cart Settings
   • Or use bulk actions to mark multiple products

2. Configure Messages

   • Go to Gold Cart → Messages
   • Customize each message type
   • Save changes

3. Monitor Members

   • View Gold Cart status in Users list
   • Check statistics in Gold Cart → Settings
   • Manually override status if needed

For Customers

1. Become a Gold Cart Member

   • Complete all account details
   • Add 10-digit phone number
   • Status updates automatically

2. Access Premium Products

   • Gold Cart products become visible
   • Add to cart like normal products
   • Maintain complete profile to keep access

Testing

Verification Script

Run the verification script to check installation:

wp eval-file wp-content/plugins/gold-cart/verify.php

Health Check

Add ?health_check=1 to the Gold Cart settings page URL to run diagnostics.

Test Helpers

The plugin includes test helper functions for developers:

• indgc_create_test_user($complete_profile)
• indgc_create_test_product($is_premium)
• indgc_get_plugin_stats()
• indgc_verify_hooks()
• indgc_health_check()

File Structure

gold-cart/
├── features/
│   ├── member-status/       # Core membership logic
│   ├── account-fields/      # Phone field management
│   ├── premium-products/    # Product restrictions
│   ├── member-messages/     # Message system
│   └── account-indicator/   # Dashboard display
├── admin/                    # Admin interface
├── js/                       # JavaScript modules
├── css/                      # Compiled styles
├── sass/                     # Source styles
├── includes/                 # Global functions
└── gold-cart.php            # Main plugin file

Development

Coding Standards

• Functional programming approach
• Single responsibility per file
• Function prefix: indgc_
• CSS prefix: indgc-
• Meta keys: _indgc_*
• Options: indgc_*

JavaScript

• ES6 modules
• Feature-based architecture
• Automatic initialization

Styling

• SCSS source files
• Gold color theme (#d4af37)
• Mobile responsive
• BEM methodology

Security

• All nonces verified
• Capabilities checked
• Output escaped
• Input sanitized
• Direct file access prevented

Hooks

Actions

• woocommerce_save_account_details - Status updates
• woocommerce_account_dashboard - Status display
• template_redirect - Premium product access
• wp_loaded - Cart cleanup

Filters

• pre_get_posts - Product filtering
• woocommerce_related_products - Related products
• manage_users_columns - User list column
• bulk_actions-edit-product - Bulk actions

Support

For issues or questions, please refer to:

• CLAUDE.md - Technical documentation
• TESTING.md - Testing guide
• verify.php - Verification script

License

This plugin is proprietary software. All rights reserved.

Credits

Developed by Mike Dion (https://becomeindelible.com)

Version: 1.0.0
Last Updated: Plugin Complete