Description
Advocacy Manager Parliamentary Directory helps you manage Australian parliamentary contacts in WordPress and display them on your website.
Keep members, contact details, official positions and portfolio appointments together in five linked directory sections, powered by Pods – Custom Content Types and Fields.
Import an editable Excel workbook, review the proposed changes and choose when to apply them. Use the Shortcode Builder to display a directory on a page or post.
Included in the free plugin
- Parliamentary contacts: store members, jurisdictions, portfolios, appointments and official positions, including email addresses, phone numbers and contact-form links.
- Workbook import and export: download an editable XLSX workbook, make changes and import it back into your site.
- Review before applying: see additions and updates before confirming an import. Choose to update matching records or add new records only.
- Resumable imports: apply changes with progress feedback, and resume an interrupted import from saved progress.
- Rollback: undo a supported import while its review history and required records remain available.
- Directory shortcodes: select a jurisdiction, chamber, party or electorate and choose contact-card or table output.
- Signed datasets: import signed releases from advocacymanager.com.au as part of a subscription service.
Workbook import, export and directory display work without a purchase, licence key or service account.
Start with the Federal Parliament sample
An optional Download Sample Data link provides a free Federal-only workbook. Download it, upload it through Workbook Import, review the changes, and confirm the import. The sample refreshes with each plugin release; it is a snapshot for evaluation, not a continuously updated directory.
No parliamentary dataset is included in the plugin ZIP. Downloading the sample does not import any data or affect your site.
Optional maintained data
A separate paid Advocacy Manager data subscription provides maintained, signed datasets for Australian Federal, State, and Territory jurisdictions. This service is optional and does not unlock the free plugin features. See plans and pricing.
Optional update checks and release-announcement emails are disabled by default. Importing a dataset always requires an administrator to review and confirm the changes.
Requirements and support
Install the latest version of Pods – Custom Content Types and Fields (minimum 3.3.0). WordPress 6.2 or newer, PHP 8.0 or newer, and the PHP ZIP and SimpleXML extensions are required.
Privacy and mail diagnostics
Mail health checks inspect active mail integrations without sending test messages or reading credentials. The plugin stores only the most recent send outcome, its time, and a hashed integration identity. This diagnostic does not store message content, recipients, or raw mail-provider errors. Accepted mail does not guarantee inbox delivery. Run a new mail test after changing mailer settings.
Plugin updates
Plugin updates are handled via the standard WordPress.org update system. The plugin does not use an external software updater. Signed workbook datasets are separate data files and workbook import does not require a subscription.
External services
The optional ‘Download Sample Data’ link will open a Federal Parliament sample workbook in your browser. The plugin doesn’t automatically contact that address. Clicking the link will generate a standard browser download request to advocacymanager.com.au. The link itself doesn’t contain a licence key or directory records. You can download the file and then upload it through Workbook Import to validate and review the changes before applying them. This is a public sample download, so it doesn’t require a purchase or a service account, and it isn’t connected in any way to the signed paid datasets.
Connecting the optional paid data service sends the data subscription license key to the HTTPS service you choose. (default: https://advocacymanager.com.au/wp-json/advocacy-data/v1). The service verifies your subscription and returns release metadata or a temporary protected workbook download. It does not receive directory records or visitor addresses. Daily checks and purchaser email announcements are separate opt-in settings; both start disabled. The publisher stores purchase/customer IDs and the email preference; announcement recipients are selected from subscription customer records at preview and send time. Email links let purchasers stop release announcements. Disconnect removes the locally saved key; unsubscribe separately to stop purchaser emails.
Advocacy Manager privacy policy: https://advocacymanager.com.au/privacy-policy/.
Advocacy Manager service terms: https://advocacymanager.com.au/terms-and-conditions/. Review your selected publisher’s terms and privacy notice before connecting.
The subscription service manages protected workbook delivery and purchase verification. Its privacy policy and terms of service explain how customer information is handled. No service account or purchase is required for manual workbook imports.
Installation
- Install and activate the latest Pods – Custom Content Types and Fields plugin.
- In Plugins > Add New, search for Advocacy Manager Parliamentary Directory and select Install Now. Alternatively, upload its ZIP through Upload Plugin.
- Activate Parliamentary Directory and open Parliamentary Directory > Dataset & Updates > Workbook Import.
- Select Download Sample Data, or use a workbook previously created by Workbook Export. Upload the workbook and select Check workbook.
- Choose how to update the directory, select Preview changes, review the proposed changes and confirm Update directory.
- Open Shortcode Builder, choose the contacts and display format, then copy the shortcode into a page or post.
For signed releases, add the publisher key ID, dataset ID, and public Ed25519 key in Settings > Trusted Publishers before using Dataset Import. Ordinary workbooks and the Federal sample do not require a publisher key.
FAQ
Is the plugin free?
Yes. Workbook import, export, reviewed updates, rollback and directory shortcodes are available without payment or a service account. Maintained data subscriptions are a separate optional service.
What data is included?
No dataset is bundled. A free Federal Parliament sample workbook is available via Download Sample Data. You can import your own compatible workbook or opt for one of the optional maintained data subscriptions for wider coverage.
Will the plugin update parliamentary records automatically?
No. Optional daily checks can be set up to alert the admin to the availability of new paid dataset releases, but the actual download and application of a release will still require admin action. You’ll have to review the proposed changes before you can confirm them.
What is the difference between Workbook Import and Dataset Import?
Workbook Import accepts editable workbooks without a publisher signature. Dataset Import verifies signed releases against trusted publisher keys.
Can I keep local changes?
Signed dataset imports offer a keep-local-changes mode. Workbook imports offer update-matching-records and add-new-records-only options. Review the explanation and proposed changes for your selected mode before confirming.
What happens if an import is interrupted?
Changes are processed in small batches. Reopen the import and continue from its saved progress. The plugin does not automatically retry a failed request when the failure is uncertain.
Can I undo an import?
Supported imports can be rolled back with their associated records and review history still available. Always take a database backup prior to making major changes and don’t empty Trash or delete import history should you ever need to roll back an import.
Does the plugin work without Pods?
No. Pods – Custom Content Types and Fields provides the linked directory data structures and must remain active.
Will deleting the plugin delete my directory?
Data is retained unless you enable Delete all the plugin data on uninstall. To remove all data, use Prepare for removal before deactivating. Preparation permanently deletes the owned directory records and five Pods in small steps; it cannot be undone.
Screenshots





Changelog
1.6.13
- Initial WordPress.org release.
- Manage parliamentary contacts with linked directory records, reviewed workbook imports, exports and directory shortcodes.
