Installation

Installation

OLoyalty is the WooCommerce loyalty, rewards, and referrals engine for the Orravo suite. Six engines in one plugin: points, tiers, rewards, gift cards, store credit, referrals.

Requirements

• WordPress 6.5+
• PHP 8.1+
• WooCommerce 8.0+ (HPOS and Cart/Checkout Blocks compatible)
• Orravo Core (declared via Requires Plugins: orravo-core)

Install steps

1. Upload the oloyalty folder to /wp-content/plugins/.
2. Activate OLoyalty in Plugins, Installed Plugins.
3. Open OLoyalty in wp-admin and confirm the Dashboard renders.

What activation creates

OLoyalty_Activator::activate() creates 13 database tables via OLoyalty_DB::activate():

• wp_oloyalty_members
• wp_oloyalty_ledger (append-only points ledger)
• wp_oloyalty_tiers
• wp_oloyalty_rewards
• wp_oloyalty_redemptions
• wp_oloyalty_giftcards
• wp_oloyalty_giftcard_transactions
• wp_oloyalty_credit_balances
• wp_oloyalty_credit_transactions
• wp_oloyalty_referrals
• wp_oloyalty_earn_rules
• wp_oloyalty_campaigns
• wp_oloyalty_audit_log

It also seeds default tiers and earn rules (idempotent: OLoyalty_DB::seed_if_empty() only inserts if the relevant table is empty).

HPOS

OLoyalty declares compatibility with WooCommerce custom order tables and cart/checkout blocks on before_woocommerce_init.