Quick Start

Members (2 minutes)

1. Log in to the site (request an account if you don’t have one).
2. Open Current Activities and pick a trip or training event.
3. Read grade & description → click Nominate.
4. Check status in My Activities. Await approval email.

Activity Leaders (5 minutes)

1. Create a new Activity (WP Admin → Activities → Add New).
2. Fill core fields: Type, Grade, Dates, Assembly Location, Max Vehicles.
3. Add clear description (requirements, equipment, comms channel).
4. Monitor nominations on the Activity Page or Admin interface.
5. Approve pending nominations. Send pre-trip email.

Administrators (10 minutes)

1. Visit Activities → Activity Settings: confirm Types & Grades.
2. Review default email templates & adjust branding.
3. Verify required pages (including this manual) exist & are published.
4. Create first test Activity & perform a sample nomination.
5. Confirm emails deliver (consider SMTP plugin if not).

Back to Top

Plugin Overview

The 4WD Club Activities Plugin is a comprehensive WordPress solution designed specifically for 4WD clubs to manage their activities, trips, training events, and member participation. This plugin transforms your WordPress site into a complete activity management system with advanced features for both administrators and members.

Member Guide

Getting Started

As a club member, you can participate in activities, propose new trips, and manage your nominations through the plugin’s user-friendly interface.

Viewing Available Activities

1. Navigate to the Current Activities page to see all upcoming activities
2. Use the filter options to find activities by type (Trips, Training, Events)
3. Click on any activity title to view full details including description, dates, and leader information
4. Check the participant list to see who else is going

Nominating for Activities

1. Log in to your account (required for all nominations)
2. Find an activity you want to join and click the “Nominate” button
3. Your nomination will be submitted and await approval from the activity leader
4. You’ll receive email notifications when your nomination status changes
5. Check your nomination status on the activity page or in “My Activities”

Managing Your Nominations

1. Visit the “My Activities” page to see all your nominations
2. View your nomination status: Pending, Approved, or Declined
3. Withdraw from activities if needed (confirmation required)
4. See your complete activity history and participation record

Proposing New Activities

1. Go to the “Propose Activity” page
2. Fill out the activity proposal form with complete details
3. Include activity name, type, grade, dates, and description
4. For multi-day trips, add sub-activities for each day
5. Submit your proposal for coordinator review
6. You’ll be notified when your proposal is approved or requires changes

Activity Leader Guide

Managing Your Activities

As an activity leader, you have additional tools to manage participants, communicate with members, and oversee your activities.

Creating Activities

1. Log in and navigate to Activities → Add New in the WordPress admin
2. Enter the activity details including name, type, grade, and dates
3. Set maximum participants and assembly location
4. Write a detailed description including requirements and what to bring
5. For multi-day trips, create sub-activities for each day
6. Submit for approval (unless you have direct publishing rights)

Managing Nominations

1. Access the Activity Administration page for comprehensive management
2. Review pending nominations in the “Nominations” tab
3. Approve or decline nominations based on experience and activity requirements
4. Use bulk actions to process multiple nominations at once
5. Monitor participant numbers against your maximum capacity

Communicating with Participants

1. Use the bulk email feature to send updates to approved participants
2. Download participant contact lists in CSV format
3. Send pre-activity briefings with meeting details and requirements
4. Follow up after activities for feedback and reports

Activity Grading System

Shortcodes Reference

Add these shortcodes to any WordPress page to surface plugin functionality:

• [current_activities_list] – Filterable list of upcoming activities.
• [proposed_activity_form] – Member activity proposal form.
• [activity_success] – Confirmation page contents after a proposal.
• [activity_admin_page] – Frontend administration dashboard (leaders/admins).
• [my_activities] – Logged-in member nominations & history.
• [4wd_activities_user_manual] – This manual.

Back to Top

Roles & Capabilities

Core WordPress roles integrate with plugin capabilities. Assign custom capabilities using your preferred role editor if needed.

Key Capabilities (examples)

• manage_activities – Create / edit / manage activities.
• approve_nominations – Approve or decline member nominations.
• send_bulk_emails – Use communication tools.
• manage_reports – Access reporting & CSV exports.
• view_member_data – View history / profile statistics.

Suggested Mapping

• Administrator: All capabilities.
• Editor: Activity & nomination management, bulk emails.
• Author: Create/manage own activities, approve nominations for their activities.
• Contributor: Propose activities only.
• Subscriber: Nominate & view history.

Back to Top

Glossary

• Activity: A trip, event, training session, or social gathering.
• Sub-Activity: A segment (e.g. Day 2 of a multi-day trip) tied to a parent activity.
• Nomination: A member’s request to participate in an activity.
• Grade: Difficulty indicator (1–6) guiding suitability & required vehicle prep.
• Leader: Member assigned to coordinate an activity.
• Status (Nomination): Pending → Approved / Declined (or Withdrawn).
• Status (Activity): Pending, Approved (publish), Cancelled, Declined (draft).
• Waitlist: Overflow list when capacity reached (if implemented per club policy).

Back to Top

Security & Privacy

Built-In Measures

• Nonce validation on all forms (prevents CSRF).
• Capability checks gate administrative actions.
• Sanitisation & escaping patterns for stored / rendered fields.
• GDPR export & erase compatibility via WordPress core tools.

Operational Recommendations

1. Enforce HTTPS site-wide.
2. Use role principle of least privilege.
3. Install an SMTP plugin & set SPF/DKIM to ensure email authenticity.
4. Schedule periodic database backups (daily incremental recommended).
5. Review logs after major events (large trips / bulk emails).

Back to Top

Customisation

Styling

• Override CSS by adding rules to your theme or a custom plugin stylesheet loaded after the plugin’s CSS.
• Create a user-manual.css in your theme & dequeue the default if needed.

Templates

Copy template files from plugins/4wd-club-activities/templates/ into your theme under fwd-activities/ (create directory) to override safely (future-proofing updates).

Extensibility Hooks (Examples)

• init – Register additional activity taxonomies.
• wp_mail filter – Modify outbound email headers or content.
• the_content filters – Inject supplemental activity meta.

Back to Top

Administrator Guide

Plugin Configuration

Administrators have full control over plugin settings, user management, and system configuration.

Initial Setup

1. Navigate to Activities → Activity Settings in WordPress admin
2. Configure activity types (Trips, Training, Events, etc.)
3. Set up difficulty grades with descriptions
4. Configure email notification templates
5. Set coordinator contact information
6. Test the system with sample activities

User Management

1. Assign appropriate roles to club members and leaders
2. Configure user capabilities for activity management
3. Set up activity leaders with proper permissions
4. Monitor user activity and participation levels

Content Management

1. Review and approve proposed activities
2. Monitor activity nominations and approvals
3. Generate reports for club management
4. Manage bulk communications to members
5. Maintain activity archives and historical data

Email System Configuration

The plugin uses WordPress’s built-in email system. For better delivery rates, consider:

• Installing an SMTP plugin like WP Mail SMTP
• Configuring your mail server settings
• Testing email delivery with different member addresses
• Customizing email templates with your club’s branding

Troubleshooting

Common Issues and Solutions

Nomination Issues

Email Issues

Page Display Issues

Getting Help

• Contact your club administrator for account issues
• Check this manual for detailed instructions
• Report bugs or request features through your club’s communication channels
• Consult WordPress documentation for general website issues

Support & Development

Technical Specifications

• WordPress Version: 4.7 or higher (6.6+ recommended)
• PHP Version: 7.0 or higher (8.0+ recommended)
• Database: MySQL 5.6 or higher
• Memory: 128MB PHP memory limit (256MB recommended)

Plugin Compatibility

• Caching: Compatible with WP Rocket, W3 Total Cache, WP Super Cache
• Email: Works with WP Mail SMTP, Easy WP SMTP, Post SMTP
• Security: Compatible with Wordfence, Sucuri, iThemes Security
• SEO: Works with Yoast SEO, RankMath, All in One SEO

Support Resources

• Plugin documentation and updates
• Community support forums
• Professional support options
• Feature requests and bug reports

Privacy and Data Protection

The plugin is designed with privacy in mind and includes GDPR compliance features:

• Data export capabilities for member information
• Data deletion options for account closure
• Secure data storage in your WordPress database
• No external data transmission except for emails