> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinedigital.co/llms.txt
> Use this file to discover all available pages before exploring further.

# RafflePress Enhancer

> A WordPress plugin that improves overall administration as well as the workflow between RafflePress and FluentCRM.

## Requirements

* WordPress 6.9+
* PHP 8.1+
* [RafflePress](https://wordpress.org/plugins/rafflepress/)
* [RafflePress Pro](https://tidd.ly/4pN4YAT) (Optional)

## Installation

1. Install and activate **RafflePress** or **RafflePress Pro**.
2. Download the latest **RafflePress Enhancer** version from [your Pine Digital account](https://pinedigital.co/account/downloads).
3. In WordPress: **Plugins → Add New → Upload Plugin**, upload **RafflePress Enhancer**, and **activate it**.

## Modules

### Giveaway Administration

#### Giveaways Per Page

RafflePress locks the giveaways admin list at 10 per page. **Giveaways Per Page lets you pick 10, 25, 50, or 100—and change it from settings or right from the list of giveaways.**

### FluentCRM

#### **Auto-Add Verified Entrants**

Automatically add RafflePress entrants who have had their email address verified to a particular FluentCRM **List** and optionally apply selected **Tags**.

<AccordionGroup>
  <Accordion title="What are the requirements?">
    * RafflePress active
    * [FluentCRM](https://influencewp.com/deal/marketing/fluentcrm/) active
    * Integrations module enabled
    * FluentCRM Sync enabled
    * FluentCRM List selected
  </Accordion>

  <Accordion title="How do we enable this?">
    1. Go to **Settings → PD Rafflepress**
    2. Enable **Integrations**
    3. Open **Settings** on the Integrations card
    4. Enable **FluentCRM Sync**
    5. Choose a **FluentCRM List** (required) and **FluentCRM Tags** (optional)
    6. Click **Save Changes**
  </Accordion>

  <Accordion title="What if an entrant is already an existing FluentCRM contact?">
    If the contact already exists, FluentCRM **updates** them rather than creating a duplicate, and attaches the list/tags you pass in.

    We then set a transient for one year. If that same contestant is verified/synced again, we skip calling FluentCRM.
  </Accordion>

  <Accordion title="Are tags removed from existing FluentCRM contacts?">
    No, our plugin is additive only; it does not remove tags.
  </Accordion>
</AccordionGroup>

#### Import From Giveaways

One-click import of RafflePress giveaway contestants into any FluentCRM list. Choose statuses, tags, and how to treat existing contacts.

<AccordionGroup>
  <Accordion title="What are the requirements?">
    * Integrations module enabled
    * FluentCRM active
    * At least one non-archived giveaway with contestants
  </Accordion>

  <Accordion title="How do we enable this?">
    1. Go to **Settings → PD RafflePress**
    2. Open **Integrations**
    3. Scroll to **FluentCRM → Import From Giveaways** (no separate toggle; tool is always available when FluentCRM is active)
  </Accordion>

  <Accordion title="How does this work?">
    * Pick one or more giveaways (or all), contestant statuses, lists, optional tags, contact status (Subscribed / Pending), and Existing Contacts (Update / Skip)
    * Runs in batches via AJAX; shows imported / skipped / failed counts when done
    * Soft-deleted contestants are excluded; does not change live FluentCRM Sync settings or markers
  </Accordion>
</AccordionGroup>

#### FluentCRM (Tag Contacts By Giveaway)

Auto-sync verified RafflePress entrants with a per-giveaway FluentCRM tag.

<AccordionGroup>
  <Accordion title="What are the requirements?">
    * RafflePress and FluentCRM active
    * FluentCRM module enabled
    * Auto-Add Verified Entrants on, with a FluentCRM List saved
    * At least one giveaway and one FluentCRM tag
  </Accordion>

  <Accordion title="How do we enable this?">
    1. **Pine Digital →** \*\*RafflePress Enhancer → \*\*Enable FluentCRM and open Settings
    2. Turn on Auto-Add Verified Entrants
    3. Set FluentCRM List (required) and FluentCRM Tags (optional, all giveaways)
    4. Under Giveaway Tags, click Add Giveaway Tag, pick a giveaway and one tag
    5. Save Changes
  </Accordion>

  <Accordion title="How does this work?">
    * Runs only after Email Verified (confirmation link or admin verify)
    * Unmapped giveaways get global tags only
    * Existing FluentCRM tags are never removed
    * Import From Giveaways does not use this map
    * Changing a mapping later does not update already-synced contestants
  </Accordion>
</AccordionGroup>