📚 Gaenity Community Plugin

🚀 Getting Started

Installation

1. Upload the gaenity-community folder to /wp-content/plugins/
2. Activate the plugin through the Plugins menu in WordPress
3. Go to Gaenity Community → Settings to configure

Requirements

• WordPress 5.8 or higher
• PHP 7.4 or higher
• Elementor 3.0+ (optional - for widget support)

📝 All Shortcodes

Community Home

Displays the main community landing page with stats, regions, industries, challenges, and recent discussions.

Resources Grid

Shows all resources with download functionality and free/paid tabs.

Registration Form

Member registration form with profile fields.

Login Form

Simple login form for existing members.

Discussion Form

Form for members to submit new discussions (requires login).

Discussion Board

Lists all discussions with filtering by region, industry, and challenge.

Polls

Community polls with live results (members only).

Ask an Expert

Form to request expert consultation.

Expert Registration

Form for experts to apply for approval.

Contact Form

General contact form with marketing opt-in.

Community Chat

Live community chat with auto-refresh.

Member Dashboard

Personal dashboard showing member stats and activity (requires login).

Expert Directory

Directory of all approved experts with profiles.

💳 Payment Gateway Setup

Overview

The plugin supports multiple payment gateways for selling courses, resources, and expert consultations.

Supported Gateways

• Stripe - Credit/debit cards (Global)
• PayPal - PayPal accounts (Global)
• Paystack - Cards, bank transfer, mobile money (Africa)
• Bank Transfer - Manual payment verification

Configuration Steps

1. Go to Gaenity Community → Settings
2. Scroll to Payment Gateways section
3. Check the gateways you want to enable
4. Select your currency (USD, EUR, GBP, NGN, etc.)
5. Enter API keys for each enabled gateway
6. Click Save Settings

Stripe Setup

1. Create account at stripe.com
2. Go to Developers → API Keys
3. Copy Publishable key and Secret key
4. Paste into plugin settings
5. Select Test Mode for testing, Live Mode for production

PayPal Setup

1. Create account at developer.paypal.com
2. Go to My Apps & Credentials
3. Create app and get Client ID and Secret
4. Paste into plugin settings
5. Select Sandbox for testing, Live for production

Paystack Setup

1. Create account at paystack.com
2. Go to Settings → API Keys & Webhooks
3. Copy Public key and Secret key
4. Paste into plugin settings

Bank Transfer Setup

1. Enable Bank Transfer in settings
2. Enter your bank account details in the text area
3. Include: Bank name, account number, account name, routing/sort code
4. These details will be shown to customers at checkout

📚 Enablement Courses

Creating Courses

1. Go to Enablement Courses → Add New
2. Enter course title and description
3. Add featured image (recommended: 800x600px)
4. In the right sidebar, set:
   • Course Type: Free, One-time Purchase, or Subscription
   • Price: Amount in your selected currency
   • Duration: e.g., "6 weeks", "3 months"
5. Click Publish

Displaying Courses

Shows all published courses in a beautiful grid with pricing and enrollment buttons.

Checkout Process

1. Create a page titled "Checkout"
2. Add shortcode: [gaenity_checkout]
3. Publish the page
4. When users click "Enroll Now" on any course, they'll be taken to checkout

💰 Managing Transactions

Viewing Transactions

Go to Gaenity Community → Transactions to see all payments.

Transaction Statuses

• Pending: Payment initiated but not completed
• Awaiting Confirmation: Bank transfer submitted, needs manual approval
• Completed: Payment successful and verified
• Failed: Payment did not go through

Approving Bank Transfers

1. Customer selects bank transfer at checkout
2. They see your bank details and make the transfer
3. Transaction appears as "Awaiting Confirmation"
4. Verify payment in your bank account
5. Click Approve button to mark as completed
6. Customer gets access to the course/resource

📄 Recommended Page Setup

💬 Forum Setup

Overview

The forum is automatically available at /community-discussions/ once you activate the plugin.

Key Features

• Filtering: Users can filter by Industry and Region
• Voting: Upvote/downvote discussions
• Comments: Reply to discussions
• Sidebar Widgets: Quick Actions, Ask Expert, Become Expert, Polls

URL Structure

• Forum Archive: /community-discussions/
• Single Discussion: /community-discussions/discussion-title/
• Filtered: /community-discussions/?industry=retail®ion=africa

Creating a Discussion Form Page

1. Create page: "Start Discussion"
2. Add shortcode: [gaenity_discussion_form]
3. Go to Settings → Page URLs
4. Set "Discussion Form Page" URL
5. Save settings

🚀 Complete Site Setup Guide

Step 1: Create All Pages

Step 2: Configure Settings

Go to Gaenity Community → Settings and configure:

1. Colors: Set primary and secondary brand colors
2. Page URLs: Enter URL for each page you created
3. Payment Gateways: Enable and configure payment methods
4. Currency: Select your preferred currency

Step 3: Add Demo Content (Optional)

1. Go to Gaenity Community → Settings
2. Scroll to "Demo Content" section
3. Click "Add Dummy Content"
4. This creates sample discussions, resources, and polls for testing

Step 4: Create Initial Content

• Resources: Gaenity Community → Resources → Add New
• Courses: Enablement Courses → Add New
• Polls: Community Polls → Add New

📊 Analytics & Reporting

Data Collected

All user interactions capture Region, Industry, and Role for analytics:

• User Registrations: Full profile with demographics
• Discussions: Region, Industry, Challenge tagged
• Resource Downloads: User Region, Industry, Role
• Poll Votes: Region and Industry segmentation
• Expert Requests: Region, Industry, Challenge
• Transactions: Purchase history by user/item

Viewing Reports

Access data from admin pages:

• Resource Downloads: See who downloaded what, with demographics
• Transactions: View all payments and statuses
• Expert Requests: Filter by region/industry/challenge
• Contact Messages: View all inquiries
• Chat Messages: Monitor community conversations

Exporting Data

Use these SQL queries in phpMyAdmin or similar tool:

⚙️ Plugin Settings

Color Customization

Go to Gaenity Community → Settings

• Primary Color: Main brand color for buttons and highlights
• Secondary Color: Accent color for gradients

Page URLs Configuration

Set custom URLs for navigation buttons:

• Registration Page: Where "Create Account" button links to
• Ask Expert Page: Where "Ask an Expert" button links to
• Become Expert Page: Where "Become an Expert" button links to
• Resources Page: Where "Browse Resources" links to

🔧 Admin Features

Approving Experts

1. Go to Gaenity Community → Expert Requests
2. Filter by "Expert Registrations"
3. Review the application
4. Click "Approve" to create their WordPress account with expert role
5. They will appear in the Expert Directory

🔄 User Workflows

Member Journey

1. Visitor arrives at Community Home
2. Clicks "Create Account" → Fills registration form
3. Becomes a member → Can access Dashboard
4. Posts discussions, downloads resources, requests expert help
5. Dashboard shows their activity stats

Expert Journey

1. Visitor clicks "Become an Expert"
2. Fills expert registration form with credentials
3. Admin reviews application in backend
4. Admin approves → Expert account created
5. Expert appears in Expert Directory
6. Members can request consultations

🎨 Customization

Using with Elementor

The plugin includes an Elementor widget:

1. Edit page with Elementor
2. Search for "Gaenity Community Block" widget
3. Drag to canvas
4. Select which block to display from dropdown

Custom CSS

All plugin elements use classes prefixed with .gaenity- for easy targeting:

🔍 Troubleshooting

Buttons Not Working

Problem: Navigation buttons link to # and don't go anywhere

Solution: Set page URLs in Gaenity Community → Settings → Page URLs

No Experts Showing

Problem: Expert Directory is empty

Solution: Go to Gaenity Community → Expert Requests and approve expert applications

Forms Not Submitting

Problem: Forms show "Security check failed"

Solution: Clear your cache and refresh the page. Check if you have caching plugins that might interfere with nonces.

Discussions Not Filtering

Problem: Clicking region/industry doesn't filter

Solution: Ensure the archive template is in gaenity-community/templates/ folder