Event Planner CRM¶
Overview¶
Event Planner CRM is Nigall’s workspace for professional event planners—solo freelancers and agencies alike. It combines client management, a project pipeline, contact lists (venues, vendors, partners), partnership agreements, and the ability to create events on behalf of clients with optional read-only client access to live event data.
The module lives at /planner/ and appears in the Tools Hub as Event Planner CRM for users with the Planner CRM add-on on Growth or higher (planner_crm_addon) or platform staff.
Purpose¶
Give planners one system for CRM-style operations instead of juggling spreadsheets, email threads, and separate event tools—while keeping clients informed without granting edit access.
Who should use it¶
| Role | Use case |
|---|---|
| Solo / freelance planner | Use your name as Business / display name; track leads → confirmed projects and planner fees |
| Event planning agency | Same CRM under a company display name; invite staff on Team (/planner/team/) |
| Client stakeholder | Read-only view of event progress (registrations, budget summary, vendors, schedule) |
| Platform admin | Support planner accounts and troubleshoot access |
Solo vs agency¶
- CRM records belong to the planner user who owns
EventPlannerProfile(not an Organization). - Individuals and companies both work: set Business / display name to your personal name or agency name.
- Agencies add managers/members under Team. Members operate the owner’s CRM workspace; the Planner CRM add-on can be billed on the owner or on an Organization that unlocks access for members.
- Organization billing unlocks the tool; it does not move CRM ownership to the org.
Benefits¶
- Central client directory for companies, individuals, and couples
- Project pipeline from lead through completed/cancelled (client is required on every project)
- Reusable venue, vendor, and partner contacts with ratings and rate history
- Partnership agreements with commission tracking and referred-project revenue
- Create Event from a project—auto-links the new event to the pipeline
- Client viewers on events: read-only dashboard for your client’s team
Navigation path¶
| Action | Path |
|---|---|
| Planner CRM dashboard | /planner/ |
| Edit planner profile | /planner/profile/ |
| Agency team | /planner/team/ |
| Clients | /planner/clients/ |
| Projects (pipeline) | /planner/projects/ |
| Partnerships | /planner/partnerships/ |
| Venue contacts | /planner/contacts/venues/ |
| Vendor contacts | /planner/contacts/vendors/ |
| Partner contacts | /planner/contacts/partners/ |
| Import from linked event | Project detail → Import stakeholders into CRM |
| Save public venue | /venues/<slug>/ → Add to Planner CRM |
| Tools Hub entry | /events/tools/ → Event Planner CRM |
| Manage client viewers | /planner/events/<pk>/<event_tag>/client-viewers/ |
| Create event (from project) | Project detail → Create Event → /events/create/ |
| Client read-only event view | /events/<pk>/<event_tag>/ (when added as client viewer) |
Tip: Subscribe to Growth+ with the Planner CRM add-on from Billing & Subscriptions, then set User type to Event Planner on Edit Profile.
Prerequisites¶
| Requirement | Details |
|---|---|
| Subscription | Growth+ Tools plan and Planner CRM add-on (planner_crm_addon) — CRM only; Ops tools come from your base plan |
| User type | event_planner recommended (or create an EventPlannerProfile) |
| Authentication | Signed-in user |
| Client before project | At least one Client is required before New Project can succeed |
| Client viewer accounts | Client must already have a Nigall account (matched by email) |
Platform admins and superusers bypass plan gating.
Step-by-step instructions¶
Beginner — Set up your planner workspace¶
- Subscribe at
/pricing/→ Platform Tools → add Planner CRM on Growth/Operations/Complete, or/pricing/subscription/?plan=pro&crm=1. - Open Tools Hub → Event Planner CRM (
/planner/). - Click Edit Profile and complete:
- Business / display name (your name or agency name)
- Specialties (including Weddings & Celebrations if applicable)
- Years of experience, service coverage area, certifications, bio
- Portfolio — add past events (title, date, location, description, URL) - Click Add Client and choose type:
- Company — organization name + primary contact
- Individual — person name (primary contact optional; filled from client name)
- Couple — e.g. “Alex & Jordan Rivera” + a primary contact - Optionally invite staff under Team.
[SCREENSHOT: Planner CRM dashboard with stats and pipeline]
Intermediate — Run a project workspace from lead to live event¶
- Clients → select client → New Project (or New Project from dashboard).
If you have no clients yet, the New Project form shows a banner and an Add client link. - Set Project name, Event type (e.g. Weddings & Celebrations or Business), Event date, guests, location, Status, Budget, Planner fee, and Deadline.
- After save, the project detail workspace seeds a checklist and document slots from the event type. Optionally link a Partnership.
- On the project page:
- Check off workflow tasks (or add custom ones)
- Upload documents (proposal is required before confirmation)
- Save a client contract file and mark it Sent → Signed (manual upload; no e-sign yet) - Soft warnings appear if status is Confirmed or later without a proposal or signed contract — they do not block you.
- Click Create Event when ready. Complete the event creation wizard. For weddings/private celebrations, keep the event private and use RSVP for guest headcount. The event is automatically linked to the project.
- Open Manage Client Viewers on the linked event and add your client’s email (they must have a Nigall account).
[SCREENSHOT: Project workspace with checklist, documents, and contract]
Advanced — Venue partners, contacts, and partnerships¶
There are two different “venue partner” tools:
| Tool | Path | Use when |
|---|---|---|
| Venue Contacts | /planner/contacts/venues/ |
Rolodex: names, phones, ratings, preferred flag, past events |
| Partnership Agreements (type Venue) | /planner/partnerships/ |
Formal deal: commission %, discount %, terms, signed file, referral revenue |
How to add a venue partner (end-to-end)
- Add a Venue Contact for day-to-day people at the venue (optional but recommended).
- Create a Partnership Agreement with partner type Venue, commission/discount rates, and terms.
- When a referral leads to work, create a Project, select that partnership, and mark the planner fee paid when collected — partnership Revenue generated updates automatically.
CRM contacts stay a private planner rolodex. They are not the same records as Nigall Venue, Vendor, or Sponsor Ops profiles.
Bring contacts in from events and marketplace
- On a project with a linked event, use Import stakeholders into CRM to copy the event venue, approved vendors, and active sponsors. Matches on Nigall profile, email, or name+company are updated instead of duplicated.
- On a public venue page (
/venues/<slug>/) or a vendor profile/application you can see, use Add to Planner CRM (Planner CRM add-on required). - Contact detail shows Appeared on events you planned and an Open in Nigall link when a source profile is saved. Phone, notes, and ratings stay yours — Ops data is not continuously synced back.
Volunteers and attendees are not imported (high volume and privacy). Speakers/talent import is not in this version.
Venue / vendor / partner contacts field guide:
| Field | Use |
|---|---|
| Name, company, role | Contact identity |
| Phone, email, category | Reach and classification |
| Rating (1–5) | Quality score |
| Preferred | Flag top vendors |
| Do not use | Private blacklist flag |
| COI expiry / Tax ID note / Payment terms | Planner-private compliance reminders (not Ops verification) |
| Past events | Link to events you hosted on Nigall |
| Rate history | JSON log of quoted rates over time |
Field descriptions¶
Event planner profile¶
| Field | Description |
|---|---|
agency_name |
Business / display name — personal or company |
specialties |
Multi-select event types (from platform category catalog, including Weddings & Celebrations) |
years_experience |
Integer |
portfolio |
JSON list of {title, date, location, description, url} |
certifications |
Free text, one per line |
service_coverage_area |
Regions or cities served |
bio |
Public-facing planner summary |
Planner client¶
| Field | Description |
|---|---|
client_type |
company, individual, or couple |
company_name |
Client name (unique per planner) — org, person, or couple label |
primary_contact |
Main contact; required for company/couple; optional for individual |
email, secondary_email, phone |
Contact details |
account_status |
lead, active, inactive, or vip |
referral_source |
How they found you |
preferred_channel |
Email, phone, SMS, or WhatsApp |
mailing_address, linkedin_url |
Optional relationship fields |
industry |
Sector label (mainly for companies) |
notes |
Standing notes about the client |
| Lifetime value | Derived from paid planner fees on this client’s projects |
Budget, deadline/event date, and guest count belong on each project (a client can have multiple projects with different budgets).
Planner project¶
| Field | Description |
|---|---|
client |
Required FK to a planner client |
assignee |
Optional agency team member owning the deal |
event_type |
Category that seeds checklist + document slots (blank = General) |
event_date |
Target event date for this project |
guest_count_estimate |
Estimated guests for this project |
location_text |
Venue / location note until an event is linked |
status |
lead, proposal, confirmed, planning, live, completed, cancelled |
next_follow_up |
Next chase date for this opportunity |
lost_reason / lost_at |
Required when status is Cancelled; date set automatically |
budget |
This project’s event budget |
planner_fee |
Your fee for the project |
planner_fee_status |
pending, invoiced, paid, overdue |
event |
Optional FK — linked Nigall event after creation |
partnership |
Optional referral partner agreement |
deadline |
Internal planning deadline |
Activity log¶
Clients and projects support short note / call / meeting entries (PlannerActivity) so the team shares a lightweight trail without a full inbox sync.
Project workspace (checklist, documents, contract)¶
| Piece | Behavior |
|---|---|
| Tasks | Seeded by event type; toggle done, add custom, apply template again without duplicating keys |
| Documents | Typed slots (proposal, agreement, floor plan, COI, …); upload/replace files |
| Client contract | One per project; statuses draft → sent → signed; file required to mark sent/signed |
| E-sign / BEO PDF / Excel import | Not included yet |
Client viewers (on Event)¶
| Field | Description |
|---|---|
client_viewers |
M2M to User — read-only access on event detail |
Business rules¶
| Rule | Behavior |
|---|---|
| Plan gating | Planner CRM requires Growth+ and the Planner CRM add-on unless staff |
| Client required | Every project must have a client; New Project shows guidance when none exist |
| Project → event link | Session key planner_project_id set when clicking Create Event; cleared after link |
| Client viewer access | Read-only: event page, registration/RSVP counts, budget summary, vendor list, program schedule |
| Client viewer writes | Blocked from edit, delete, check-in, RSVP POST, social sharing generate, guest list |
| Host remains planner | Events created from projects use your account as Event.host |
| Partnership metrics | revenue_generated sums planner_fee on referred projects with fee status paid |
| Team access | Agency members use the owner’s CRM via PlannerAgencyMembership; only the owner edits the profile |
User permissions¶
| Action | Planner (host) | Client viewer | Other users |
|---|---|---|---|
| Planner CRM dashboard | ✅ (Growth+ + CRM add-on) | ❌ | ❌ |
| Edit project / client | ✅ (owner / agency member) | ❌ | ❌ |
| Create event from project | ✅ | ❌ | ❌ |
| Edit linked event | ✅ (as host) | ❌ | ❌ |
| View event detail | ✅ | ✅ (read-only panel) | Per event visibility |
| Manage client viewers | ✅ (host) | ❌ | ❌ |
| RSVP / register as client viewer | ❌ (write blocked) | ❌ | Per event rules |
See also Roles & Permissions.
Workflow¶
Examples¶
Agency planning a corporate gala
- Add client type Company “Acme Corp”.
- Create project “Acme Annual Gala 2026” at status Proposal with that project’s budget (e.g. $50k–$80k).
- After sign-off, Create Event, enable Sponsors + Program modules.
- Add
finance@acme.comas client viewer so their team sees registration counts without edit access.
Venue partner (referral deal)
- Optionally add a Venue Contact for the sales manager at “Grand Hall”.
- Create a Partnership Agreement with type Venue at 10% commission.
- On a new project, select that partnership (or use New project from this partner on the partnership detail page).
- When planner fee is marked paid, partnership Revenue generated updates.
Wedding or similar private celebration
- Add client type Couple — Client name “Alex & Jordan Rivera”, primary contact one partner.
- Set planner specialties to Weddings & Celebrations (or Social Events).
- Create a project (e.g. “Rivera Wedding 2026”) with that project’s budget and deadline → Create Event.
- Keep the event private, use RSVP for guest headcount, and add the couple’s Nigall emails as client viewers.
Best practices¶
- Complete your planner profile and portfolio before pitching clients—it builds trust on Nigall.
- Always add a client before a project; use individual/couple types for private events instead of inventing fake company names.
- One project per client event; use status transitions to reflect sales stage.
- Distinguish Venue Contacts (people) from Partnership Agreements (money/terms).
- Add client viewers only after the event exists and modules are configured.
- Keep rate history on contacts for faster re-quotes.
- Use Growth+ + Planner CRM add-on for multi-client workflows; Operations Suite alone does not include CRM.
Common mistakes¶
| Mistake | Fix |
|---|---|
| CRM card locked in Tools Hub | Subscribe to Growth+ and enable the Planner CRM add-on |
| Cannot create project / empty client list | Add Client first, then New Project |
| Client viewer email not found | Client must register on Nigall first |
| Project not linked after event create | Start from project Create Event, not generic Create Event from My Events |
| Client can’t edit event | By design—client viewers are read-only |
| Confused venue “partner” | Contacts = rolodex; Partnerships = commission agreements |
relation planner_crm_* does not exist |
Run python manage.py migrate on the server |
FAQs¶
Does the Planner CRM add-on replace Operations Suite?
No. The add-on unlocks Event Planner CRM on top of your Growth / Operations / Complete plan. Ops tools still come from the base plan.
Can clients host their own events?
Yes—they can have their own organizer account separately. Client viewer access is read-only on your hosted event.
Do client viewers see host-only panels?
No. They see event details plus a Client view (read-only) panel with registrations, budget summary, vendors, and schedule.
Can I use CRM without the event_planner user type?
Yes, if you have Growth+ and the Planner CRM add-on. Platform staff also see Planner Workspace in the dashboard nav. Setting user type to Event Planner is optional but unlocks profile-oriented defaults.
Must I be a company to use Planner CRM?
No. Solo planners and agencies both work. Use Business / display name for your brand, and Team only if you have staff.
Why is Client required on New Project?
Projects are owned by a client for pipeline and fee tracking. Add a company, individual, or couple first—there is an Add client shortcut on the project form.
Troubleshooting¶
| Symptom | Cause | Fix |
|---|---|---|
| ProgrammingError: relation does not exist | Migrations not applied | python manage.py migrate |
Redirect from /planner/ to Tools Hub |
No Growth+ / CRM add-on | Subscribe at /pricing/#platform-tools |
| New Project shows empty client dropdown | No clients yet | Use Add client on the form |
| Client viewer sees RSVP form | Not added as viewer, or viewing as different user | Confirm email on Manage Client Viewers |
| Edit URL returns redirect for client | Read-only enforcement | Expected—use host account to edit |
Related features¶
- Events & Registration
- Organizer Dashboard
- Billing & Subscriptions
- Roles & Permissions
- Program & Schedule
- Vendor Management
Administrator notes¶
- App:
planner_crm— models registered in Django admin - Migrations:
planner_crm.0001_initial…0005_project_workspace,events.0040_event_client_viewers - Workspace helpers:
planner_crm.project_workspace,planner_crm.workflow_templates - Access helper:
planner_crm.services.can_access_planner_crm - Write protection:
planner_crm.event_access.get_managed_event - Tool key:
planner_crminusers/subscription_plans.py
Developer / API notes¶
| Item | Location |
|---|---|
| URLs | planner_crm/urls.py — prefix /planner/ |
| Models | planner_crm/models.py |
| Client viewer context | planner_crm.services.client_viewer_read_context |
| Event field | Event.client_viewers M2M |
No public REST API for CRM entities in v1; use Django admin or in-app UI.