PHPackages                             lindemannrock/craft-survey-campaigns - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. lindemannrock/craft-survey-campaigns

ActiveCraft-plugin[Utility & Helpers](/categories/utility)

lindemannrock/craft-survey-campaigns
====================================

Campaign management for automotive surveys with SMS and email invitations

5.2.0(3mo ago)022MITPHPPHP ^8.2CI passing

Since Jan 14Pushed 3mo agoCompare

[ Source](https://github.com/LindemannRock/craft-survey-campaigns)[ Packagist](https://packagist.org/packages/lindemannrock/craft-survey-campaigns)[ RSS](/packages/lindemannrock-craft-survey-campaigns/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (6)Dependencies (7)Versions (7)Used By (0)

Survey Campaigns for Craft CMS
==============================

[](#survey-campaigns-for-craft-cms)

[![Latest Version](https://camo.githubusercontent.com/6d1c31f585b9cd63102f954c900b08870fdfbd8a7413a688c6cc946850505546/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6c696e64656d616e6e726f636b2f63726166742d7375727665792d63616d706169676e732e737667)](https://packagist.org/packages/lindemannrock/craft-survey-campaigns)[![Craft CMS](https://camo.githubusercontent.com/21f96a88b167fb3d44f5353f9cd480b0311e4612eb2bef7725ecfc09a8b0b8d7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4372616674253230434d532d352e302532422d6f72616e67652e737667)](https://craftcms.com/)[![PHP](https://camo.githubusercontent.com/0f16581d1180dbfd4c0e13166ec1267d4ad2f2fab8281ea6d6b284cf5c65d921/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322532422d626c75652e737667)](https://php.net/)[![Formie](https://camo.githubusercontent.com/09818a1867cacd0732dee0745f70313d9612999d59bb9b5cdcbd96a59b3300cf/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f466f726d69652d332e302532422d707572706c652e737667)](https://verbb.io/craft-plugins/formie)[![License](https://camo.githubusercontent.com/806fa585ee34bf9603095fd8dbc8f1dc99bd104ccd9b1d0c5833eb6c61ea22d9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6c696e64656d616e6e726f636b2f63726166742d7375727665792d63616d706169676e732e737667)](LICENSE)

Campaign management for customer surveys with SMS and email invitations for Craft CMS 5.x.

Beta Notice
-----------

[](#beta-notice)

This plugin is currently in active development and provided under the MIT License for testing purposes.

**Licensing is subject to change.** We are finalizing our licensing structure and some or all features may require a paid license when officially released on the Craft Plugin Store.

Features
--------

[](#features)

- **Campaign Management**: Create and manage survey campaigns linked to Formie forms
    - Multi-site support with site-specific customers
    - Campaign types for organization
    - Configurable invitation delay and expiry periods
- **Customer Management**:
    - Import customers from CSV files
    - Add individual customers manually
    - Track invitation status (sent, opened, submitted)
    - Unique invitation codes per customer
    - Export customers to CSV/JSON
- **Multi-Channel Invitations**:
    - SMS invitations via [SMS Manager](https://github.com/LindemannRock/craft-sms-manager)
    - Email invitations with customizable templates
    - Bitly URL shortening for SMS links
- **Queue-Based Processing**:
    - Batch processing for large customer lists
    - Background job execution
    - Progress tracking
- **Survey Response Tracking**:
    - Link Formie submissions to customers
    - Track survey completion rates
    - Invitation expiry handling
- **Comprehensive Analytics**:
    - Customer counts per campaign
    - Submission tracking
    - Date range filtering
- **User Permissions**: Granular access control for campaigns, customers, and settings
- **Logging**: Structured logging via Logging Library with configurable levels

Requirements
------------

[](#requirements)

- Craft CMS 5.0 or greater
- PHP 8.2 or greater
- [Formie](https://verbb.io/craft-plugins/formie) 3.0 or greater
- [SMS Manager](https://github.com/LindemannRock/craft-sms-manager) 5.0 or greater (for SMS invitations)
- [Logging Library](https://github.com/LindemannRock/craft-logging-library) 5.0 or greater (installed automatically)
- [Plugin Base](https://github.com/LindemannRock/craft-plugin-base) 5.0 or greater (installed automatically)

Installation
------------

[](#installation)

### Via Composer (Development)

[](#via-composer-development)

Until published on Packagist, install directly from the repository:

```
cd /path/to/project
composer config repositories.survey-campaigns vcs https://github.com/LindemannRock/craft-survey-campaigns
composer require lindemannrock/craft-survey-campaigns:dev-main
./craft plugin/install formie-campaigns
```

### Via Composer (Production - Coming Soon)

[](#via-composer-production---coming-soon)

Once published on Packagist:

```
cd /path/to/project
composer require lindemannrock/craft-survey-campaigns
./craft plugin/install formie-campaigns
```

### Via Plugin Store (Future)

[](#via-plugin-store-future)

1. Go to the Plugin Store in your Craft control panel
2. Search for "Survey Campaigns"
3. Click "Install"

Configuration
-------------

[](#configuration)

### Settings

[](#settings)

Navigate to **Survey Campaigns → Settings** in the control panel to configure:

**General Settings:**

- **Plugin Name**: Customize the display name in the control panel
- **Campaign Section Handle**: The section handle where campaigns are stored

**Bitly Settings:**

- **Bitly API Key**: API key for URL shortening (environment variable recommended)

**Logging Settings:**

- **Log Level**: debug, info, warning, error

### Environment Variables

[](#environment-variables)

```
# .env
BITLY_API_KEY=your-bitly-api-key
```

### Config File

[](#config-file)

Create a `config/formie-campaigns.php` file to override default settings:

```