Install Gamification

Installing Gamification

Requirements

• WordPress 6.0 or later
• PHP 7.4 or later
• A database account permitted to create and update WordPress tables during activation

Installation

1. Upload cointacted-gamification.zip from Plugins → Add New → Upload Plugin.
2. Activate Cointacted – Gamification.
3. Open Cointacted → Gamification.
4. Create the first point type only after choosing the currency or reward model

that belongs on this site. Fresh installations do not add a placeholder Reputation currency.

5. Decide its display precision and transfer policy before members earn it.

The plugin is standalone. Social Terminal and community plugins are optional integrations.

Free operation does not require an account or license. Activate a verified Gamification Pro entitlement in Cointacted → Add-ons before configuring rules, achievements, ranks, campaigns, quests, streaks, leaderboards, diagnostics, or provider adapters. Deactivating Pro stops new automated processing without deleting the exact ledger or previously recorded history.

Capabilities

Activation grants these capabilities to the administrator role:

• manage_cointacted_gamification
• award_cointacted_rewards
• view_cointacted_gamification_reports
• ingest_cointacted_gamification_events

Grant capabilities to other roles only when required. Award, reversal, and event-ingestion permissions can change permanent reward records.

Integration safety

• Send amounts as strings, never floats.
• Give every transaction a stable idempotency key derived from the originating event.
• Do not generate a random idempotency key when retrying the same external operation.
• Store the returned transaction UUID in the originating system.
• Reverse incorrect transactions instead of directly changing balances.
• Use a unique external event ID for canonical event ingestion.

Data retention

Deactivation does not remove reward data. The plugin intentionally does not automatically delete ledger tables because doing so would destroy audit history.

Back up the WordPress database before migration, reconciliation, or bulk reward operations.