ADVOCACY MANAGER · CUSTOMER GUIDE

Getting Started

Install the customer plugins in the right order, import parliamentary data and configure directories, electorate maps, charts and campaigns.

For customers and WordPress administrators · Updated 12 November 2026 · Latest plugin releases

On this page: Dependencies · Install · Signed data · Lookup · Maps · Charts · Campaigner · Troubleshooting

CHOOSE YOUR PATH

Three subscription options, one shared foundation

Parliamentary Directory is the free foundational plugin. It works with your own workbook or the included Federal Parliament sample data without a paid subscription. Data, Lookup and Campaigner plans add maintained signed data and the downloads shown in your customer dashboard. The Data subscription is a service, not a separate plugin.

Customer plugin dependencies

Customer pluginMust already be activePurpose
Pods – Custom Content Types and FieldsNone within the Advocacy suiteStores the directory records and relationships.
Parliamentary DirectoryPods – Custom Content Types and Fields (latest version)Free directory foundation; imports and exports parliamentary data.
Advocacy LookupParliamentary DirectoryAddress-to-electorate searches and configurable directories.
Advocacy Lookup MapsAdvocacy LookupOptional electorate maps and neighbouring electorates.
Advocacy ChartsParliamentary DirectoryOptional chamber schematics, bar charts and pie charts.
Advocacy CampaignerAdvocacy LookupCampaign forms and AI-assisted draft messages.

Installation order: activate Pods – Custom Content Types and Fields, then Parliamentary Directory. Add Charts after Parliamentary Directory; add Lookup before Maps or Campaigner. Required plugins must remain active. Maps and Charts are optional, and neither is required by Campaigner.

Use the customer ZIPs. Advocacy Manager and Advocacy Lookup Admin are publisher-side products. They are not substitutes for Parliamentary Directory and Lookup on a customer website. On multisite, activate the customer plugins separately on each site.

One subscription licence: current Data, Lookup and Campaigner plans use the same subscription key for their included services. Enter it in Parliamentary Directory for signed data and, where included, in Lookup/Campaigner for software activation. Lookup and Campaigner share a site activation; replacing or deactivating that licence affects both. Maps uses the connected Lookup subscription; Charts uses the signed Data connection. Older separately issued licences remain supported.

Data

Maintained parliamentary records for your WordPress directory.

  • Pods – Custom Content Types and Fields + Parliamentary Directory
  • One subscription licence for signed data and Charts downloads
  • Signed data with review and Undo; optional Advocacy Charts

Go to Data setup →

Lookup

Everything in Data, plus address-to-electorate lookup and a configurable directory.

  • Pods – Custom Content Types and Fields + Parliamentary Directory + Advocacy Lookup
  • Data and Charts, plus Lookup and the optional Maps companion
  • Hosted boundary service and an included monthly lookup allowance

Go to Lookup setup →

Campaigner

Everything in Lookup, plus supporter-facing campaigns and AI-assisted message drafting.

  • Pods – Custom Content Types and Fields + Parliamentary Directory + Lookup + Advocacy Campaigner
  • AI provider and visitor-consent configuration
  • Built-in Campaigner form, private response reports and opted-in contact exports

Go to Campaigner setup →

PREPARATION

Before you install

  • WordPress administrator access: you need permission to install plugins and manage settings.
  • Hosting: install the latest stable WordPress and plugin releases, and use a supported PHP version that meets the requirements shown with the current plugin downloads. Install the latest version of Pods – Custom Content Types and Fields. Workbook imports also need PHP ZIP and SimpleXML.
  • HTTPS and scheduled tasks: use HTTPS and keep WordPress scheduled tasks working for release checks and Campaigner response cleanup.
  • Backup: take a database and files backup before upgrading an established installation or replacing directory data.
  • Customer account: open the customer dashboard to check Plans, Downloads and Licences. Download the customer packages included in your current plan.

Keep subscription licences, Google server keys, AI keys and Turnstile secrets private. Maps uses a separate browser key that is visible to visitors by design: restrict it to your website’s HTTP referrers and the Maps JavaScript API. Never put the Google server key in the browser-key field.

STEP 1 · ALL PLANS

Install the foundation plugins

  1. In WordPress, open Plugins → Add New Plugin, search for Pods – Custom Content Types and Fields, then install and activate the latest version. Visit pods.io for its homepage and documentation.
  2. Choose Plugins → Add New Plugin → Upload Plugin, upload the supplied Parliamentary Directory ZIP and activate it. If Advocacy Manager is active, deactivate it first. Keep Pods – Custom Content Types and Fields active.
  3. Open Parliamentary Directory → Health & Reports and resolve any storage, schema or Pods – Custom Content Types and Fields errors before importing data.
  4. Parliamentary Directory does not bundle parliamentary records. For a sample, open Dataset & Updates → Workbook Import → Import Sample Data. Download the XLSX, upload it on that tab, select Check workbook, choose the import mode, then Preview changes and Update directory. The sample contains the latest Australian Parliament data only; for all Australian states and territories, you will need a current subscription plan.

Parliamentary Directory is the data foundation. It maintains parliamentary jurisdictions, advocacy portfolios, members, official positions and appointments, with workbook export/import and display shortcodes.

To display the optional Powered by Advocacy Manager badge, add the Advocacy Manager Badge block or widget to a footer or sidebar supported by your theme and choose its light or dark appearance.

If you have an existing Advocacy installation, first back up its database.

STEP 2 · DATA, LOOKUP AND CAMPAIGNER

Connect your maintained parliamentary data

Data, Lookup and Campaigner subscriptions all include maintained signed parliamentary datasets. Use your subscription licence in Parliamentary Directory’s data connection. Downloading a plugin or activating its licence does not import parliamentary records.

  1. Find your subscription licence in the customer dashboard. Obtain the publisher key ID, dataset ID and public verification key from Advocacy Manager through a trusted channel.
  2. Open Parliamentary Directory → Settings → Trusted Publishers. Check or enter the publisher key ID, dataset ID and public Ed25519 key. A licence key and a public verification key are different values; never enter a private signing key.
  3. Open Dataset & Updates → Available Updates. Keep the supplied service endpoint and dataset ID, enter your subscription key in Data subscription licence key, then select Save connection and preferences.
  4. Optionally enable daily dataset checks and purchaser email announcements. These notify you about releases; they do not change directory records.
  5. Select Check now, then Download and check dataset. Alternatively, download the signed workbook from your customer dashboard and use Dataset Import → Check dataset. Keep the signed file unedited.
  6. Choose Keep my local changes — recommended or Replace my entire directory, then select Preview changes. Review additions, updates, retained records and any removals. Use See individual changes (optional) for a closer review.
  7. Confirm Update directory, or acknowledge the replacement warning and select Replace directory. The five record groups are processed together; keep the page open while the progress message is displayed.
  8. Check the import summary, affected records and your public displays. Use Undo this import if needed while the import history and rollback checks still allow it.

Protect local edits when importing data

Keep my local changes protects local edits while applying eligible publisher updates.

Replace my entire directory can overwrite local dataset fields and move records missing from the release to Trash. Back up first, inspect removals and keep Trash intact while Undo may be needed.

Undo this import and Apply & Rollback History reverse eligible applied changes. Deleting completed history removes its Undo options. A plugin downgrade does not reverse a data import, and an import with no changes has nothing to undo.

Use Workbook Export and Workbook Import for your own editable spreadsheet. Keep the required sheets, headings and record keys. Choose Update matching records and add new ones to use workbook values, or Add new records only to leave existing records unchanged. Both retain records missing from the workbook.

An editable workbook is not a signed publisher release. Use the signed Dataset Import path for subscription datasets, and never bypass signature or digest checks.

STEP 3 · LOOKUP AND CAMPAIGNER

Install and connect Advocacy Lookup

If you have Lookup or Campaigner, install the Advocacy Lookup plugin after Parliamentary Directory is functioning.

  1. Download the Advocacy Lookup customer ZIP from your customer dashboard. Use the same subscription licence that provides your Lookup or Campaigner plan.
  2. Upload and activate Lookup while Pods – Custom Content Types and Fields and Parliamentary Directory remain active. The customer package requires Parliamentary Directory, not Advocacy Manager.
  3. Open Parliamentary Directory → Advocacy Lookup → Licence and activate the subscription licence. Select Connect subscription if the hosted connection is not already established. Software activation and hosted connection are separate checks using your included entitlement.
  4. Under Lookup Settings, save your own Google server API key. Enable billing, Places API (New) and Geocoding API in your Google project. Restrict this key to those APIs and your server’s public outbound IP address. Google usage is charged separately.
  5. Select Test saved connection. Confirm access, monthly allowance and reset date, then select a genuine Australian street address from the suggestions and check its representatives. A successful hosted connection test does not replace the address test.

Publish a locator or parliamentary directory

For an address-finder page, add the Advocacy Locator block or [advocacy_lookup] in a Shortcode block. Choose the jurisdiction/chambers, display mode and contact fields in the block or shortcode settings.

For a searchable directory, open Advocacy Lookup → Directory. Create or open a configuration, choose its scope, visible contact fields and visitor filters, then use Appearance to set the view, grouping and up to three sort keys. Grouping takes precedence over sorting.

Publish the configuration when ready and use its Embed tab to copy the generated shortcode or add the Advocacy Directory block. Published configurations expose their chosen fields through the public search endpoint; leave private configurations unpublished. Directory searches use local Parliamentary Directory data and do not consume hosted lookups.

After a data import, check the directory. If its indexed results are stale, select Refresh index and clear the affected page cache.

Your subscription’s hosted allowance, usage and reset date are shown by the Lookup connection test. Base Lookup includes 5,000 completed resolutions per UTC calendar month and Campaigner includes 15,000, subject to your current entitlements and any additional capacity purchased. Unused monthly quota does not roll forward; failed resolutions and connection checks are not billed as completed lookups.

OPTIONAL COMPANION · LOOKUP AND CAMPAIGNER PLANS

Set up Advocacy Lookup Maps

Maps adds electorate boundaries, neighbouring electorates and representative cards to a Lookup locator. It uses your existing hosted Lookup subscription and the parliamentary records on your site.

  1. Download and install the Advocacy Lookup Maps customer ZIP. Activate it after Lookup; keep Lookup and Parliamentary Directory active.
  2. Create a separate Google browser API key with Maps JavaScript API enabled. Restrict it to your website’s HTTP referrers and that API. Do not reuse the server key configured for Places and Geocoding.
  3. Open Lookup Settings → Electorate maps, save the browser key and set the Computer and Tablet information box width if required.
  4. Select Electorate map in the Locator block or shortcode builder, or use [advocacy_lookup display="map"]. Choose both houses or upper houses only to show the House selector.
  5. Test an address, switch the available houses and select neighbouring electorates. Cards display available contacts and current Official Positions from your directory. Where a map is unavailable, or for a ministerial search, the locator uses representative cards.

OPTIONAL COMPANION · ALL PAID PLANS

Set up Advocacy Charts

Charts is included with signed Data subscriptions, including Lookup and Campaigner plans. The customer plugin requires active Parliamentary Directory and its directory data. It does not require Lookup or a Google key.

  1. Download the Advocacy Charts customer ZIP and activate it after Parliamentary Directory. Keep the signed Data subscription connected in Parliamentary Directory to receive Charts updates.
  2. Open Parliamentary Directory → Advocacy Charts. Under Coalitions & display, save any party groupings and jurisdiction-specific label settings.
  3. In Preview & setup, choose Chamber schematic, Bar chart or Pie chart, then select the jurisdiction and chamber.
  4. Choose the contact fields on member cards, fit-to-browser setting and label sizes. Current Official Positions appear when available. For the schematic, curved group labels appear when their group or a constituent party is selected.
  5. Under Publish this chart, choose which adjustments visitors may use. Leave them all unselected to lock the display. Select Generate shortcode, copy it into a Shortcode block, or use the Advocacy Charts block.
  6. Check the published chart, search for a member and open a contact card. These charts show the current directory’s composition; the schematic does not reproduce physical chamber seating.

STEP 4 · CAMPAIGNER

Install and configure Advocacy Campaigner

Advocacy Campaigner is available with the Campaigner subscription. It builds on the working Parliamentary Directory and Lookup service to help supporters prepare targeted, editable advocacy messages from approved campaign posts and delivers them to the chosen parliamentary representative via the supporter’s email app or the representative’s Contact URL.

  1. Download and install the Advocacy Campaigner customer ZIP with Advocacy Lookup, Parliamentary Directory and Pods – Custom Content Types and Fields active. Campaigner’s customer package requires active Lookup, including when a campaign uses a custom recipient.
  2. Open Parliamentary Directory → Advocacy Campaigner → Overview and check the dependencies. The Licence tab shares Lookup’s subscription activation; use the same key if activation is still required.
  3. In Settings, review the public drafting notice and consent text. Configure the Turnstile site and secret keys if using Turnstile. Enable Public drafting when ready to test and launch.
  4. In AI Configuration, enable AI drafting, choose OpenAI or Anthropic Claude, save your provider API key and select a supported model. Use Check AI connection. Provider usage charges are separate.
  5. Set the site daily, administrator hourly and public-session AI request limits. The defaults are 50, 10 and 3 respectively; usage is shared across both AI providers, including connection checks.
  6. In Form setup, enable the Campaigner form, edit its labels, placeholders, buttons and subscription checkbox wording, and choose whether to use Cloudflare Turnstile. No separate form plugin is required.

Turnstile and visitor consent

Everyone, including administrators and signed-in members, must accept the drafting notice. Signed-in users skip Turnstile. For signed-out visitors, Turnstile runs when enabled in Form setup; its matching site and secret keys are saved in Settings. The form opens automatically after consent and any required verification.

Signed-in members can use their saved Lookup address after consent, with manual address entry still available. With Turnstile disabled, consent and request limits still apply.

Campaigns created with the former Forminator or Gravity Forms integrations need the built-in Campaigner form and a newly approved context.

Create and approve a campaign post

  1. Create or edit a WordPress Post, enable Campaigner and set the campaign to Open. Choose the government level, chamber and any minister or portfolio scope.
  2. Review the issue briefing, AI drafting prompt and constituent choices. Set Best email priority, message destination and any CC fields. To address someone outside the directory, select Custom recipient? and enter the approved name and email; that campaign skips address lookup.
  3. Explicitly approve and activate a new campaign context version, then save the post. Reapprove when the briefing, recipient rules, prompt or destination settings change.
  4. Insert [advocacy_campaigner_form] into the campaign post. It includes the address search for representative campaigns. Use [advocacy_campaigner_form lookup="no"] only when deliberately keeping a separate Lookup interface. Use one Campaigner form per post.
  5. Publish or update the post and test in a private browser window: accept the notice, complete Turnstile if enabled, select an address and eligible representative where required, generate a draft, review and edit it, then test the copy/email-app/contact-form actions.

Campaigner prepares messages — it does not send them

The supporter reviews the text and sends it through their own email app or the representative’s contact form. A contact-form hand-off may require copying and pasting the message; Campaigner does not submit a third-party contact form automatically. A generated draft, recorded response or opened email app is not proof that a message was sent or delivered.

Open Campaigner → Form entries for response reports, View Campaigner responses and Export mailing list CSV. The export includes only contacts who opted in and removes duplicate email addresses.

Scheduled cleanup removes responses after 30 days. Before deletion, expiring opted-in contacts are emailed as a CSV to the site administration email in WordPress Settings → General. Messages and residential addresses are excluded. If email submission fails, the entries are retained for retry; manually trashed entries are not emailed. Check the administrator email and mail delivery during setup.

STEP 5 · GO-LIVE CHECKS

Test the complete installation

  • Parliamentary Directory: Health & Reports is healthy and the directory contains the intended current members, Official Positions and appointments.
  • Signed data: the subscription connects, the file validates, the preview is reviewed and the completed import summary matches expectations.
  • Lookup: licence activation and hosted connection succeed; a real address produces the expected representatives and updates usage.
  • Maps, if installed: the map loads with the browser key, the House selector works where available and contact cards display correctly on desktop and mobile.
  • Charts, if installed: the chosen chamber and chart type display correctly, contact fields and Official Positions are right, and visitor controls match your settings.
  • Campaigner: test consent and any Turnstile challenge, saved and manual addresses, recipient selection, AI drafting and the final hand-off. Check opt-in exports and the site administrator’s mail delivery.
  • Keys and caching: server keys, AI keys, licence keys and Turnstile secrets remain private. The Maps browser key is expected in browser requests and must be restricted. Check page/CDN caches after configuration changes.

Test as a signed-out visitor and a signed-in member. Both must accept the drafting notice; only signed-out visitors complete Turnstile when enabled. An administrator-only test does not cover the visitor experience.

ONGOING CARE

Keep your plugins, data and subscriptions healthy

Software updates

Check Dashboard → Updates or Plugins → Installed Plugins. Parliamentary Directory is free and currently supplied through the official WordPress plugin repository. Lookup and Campaigner are paid plugins utilising a shared subscription through our supported in-dashboard updates. Maps uses electorate boundaries via our Lookup server; Charts uses the signed Data subscription.

Parliamentary data updates

Use Dataset & Updates → Available Updates → Check now → Download and check dataset, choose the import mode, preview and confirm. Automatic checks do not apply changes and must be approved and applied by your WordPress administrator. After importing, check members, current Official Positions and portfolio appointments, then refresh any stale directory index and page cache.

Monthly and periodic checks

  • Monthly: check server Lookup allowance and any purchased capacity add-on; make sure subscription and software licences remain active. Lookup allowances reset at the start of each UTC calendar month.
  • After changes to campaigns: reapprove the new context version, review the public notice and test a signed-out visitor again. Refresh page/CDN caches after plugin, consent or form configuration changes.
  • Regularly: check backups, scheduled tasks, release email preferences, Campaigner cleanup and administrator email delivery. In Parliamentary Directory’s Housekeeping, preview retention before deleting completed import history: deletion removes the associated Undo options. Keep unfinished work and any history you still need.
  • Before expiry, cancellation or changing plans: use Customer dashboard → Plans. Subscription status and software licence/hosted-service entitlement are not the same as your local directory; previously imported Parliamentary Directory records remain on your WordPress site if your subscription ends.

QUICK FIXES

Troubleshooting

The directory is empty or outdated

Check that Pods – Custom Content Types and Fields and Parliamentary Directory are active and healthy. Parliamentary Directory starts without records: import a sample or editable workbook, or connect your subscription and complete the signed-data import. If records exist but a Lookup directory is stale, use Directory → Refresh index and clear the page cache.

A signed update is rejected

Check Parliamentary Directory compatibility, your configured publisher key ID, dataset ID and public key, and whether the release was already applied. Download a fresh trusted file if verification fails. Do not disable signature or digest validation.

Lookup cannot connect or find representatives

Check the shared subscription licence and Connect subscription, then use Test saved connection. For address failures, check Google billing, Places API (New), Geocoding API and the server key’s outbound-IP restrictions. Confirm monthly allowance and local Parliamentary Directory records. A working local directory does not confirm the hosted address service.

The Campaigner form is missing or has no representatives

Confirm Pods – Custom Content Types and Fields, Parliamentary Directory, Lookup and Campaigner are active. Enable Campaigner form in Form setup, add its shortcode to the campaign post and check that Public drafting and the approved campaign are open. Accept the notice and complete Turnstile if required. For representative campaigns, confirm the address and recipient scope; custom-recipient campaigns skip that address step.

AI drafting fails

Recheck your saved AI provider key, selected model, account billing and Check AI connection. Confirm the draft has been generated and reviewed, and that the selected representative has the required email address or contact URL. Contact-form workflows require manual paste and submission by the visitor.

A plugin will not activate

Install and activate its required parent from the dependency table above. Use the customer ZIP: packages that require Advocacy Manager or Advocacy Lookup Admin belong to the publisher installation. Check the plugin’s WordPress and PHP requirements.

A map or chart is missing

For Maps, check active Lookup, the hosted subscription, the separate browser key and its website/API restrictions, and Electorate map display mode. Missing or unavailable boundaries can fall back to representative contact cards. For Charts, check active Parliamentary Directory, imported members, the selected jurisdiction/chamber and the published block or shortcode.

If you still need help, use Support or Contact, include plugin versions, the affected screen, error text and your order reference where relevant. Do not include passwords, full licence keys, private signing keys or service secrets.

Ready to start?

Choose the subscription that matches your organisation, install the customer plugins in order and follow the checks above before making a campaign public.

Save to list

Scroll to Top