=== Polls For ActivityPub ===
Contributors: andremenrath
Tags: polls, activitypub, fediverse
Donate link: https://nlnet.nl/donating/
Requires at least: 6.9
Tested up to: 7.0
Requires PHP: 8.1
Stable tag: 1.0.7
License: AGPL-3.0-only
License URI: https://eupl.eu/
Plugin URI: https://codeberg.org/linos/wordpress-polls-for-activitypub

Fediverse compatible polls. The development of this plugin was funded by the NGI0 Core Fund, a fund established by NLnet.

== Description ==
= WordPress – Polls for ActivityPub =

This plugin works as an addon to the [WordPress ActivityPub plugin](https://wordpress.org/plugins/activitypub/). It brings lightweight polls to your WordPress site that reach the Fediverse. The polls are fully interoperable with platforms like Mastodon.

= Features =

- Modern block editor integration (Gutenberg)
- Interactive front-end for voting and viewing results
- Accepts votes from both local logged-in users and remote ActivityPub accounts (fully compatible with Mastodon)
- Email notifications for poll creators and local voters when results are available
- Configurable slug for polls and customization options for poll creation
- Votes stored as a custom WordPress comment type, with cached tallies for performance

= Source Code =

This is a community plugin. Feel free to bring up ideas, raise issues, fork the code or do anything else you like. The repository can be found at [Codeberg](https://codeberg.org/linos/wordpress-polls-for-activitypub). Check out the Wiki as well as the `CONTRIBUTING.md` and `CODE_OF_CONDUCT.dm` files for further guidance.

== Frequently Asked Questions ==

= Do I need the ActivityPub plugin? =
Yes. This plugin is an add-on for the ActivityPub plugin and requires it to function.

= Can people from Mastodon and other Fediverse platforms vote? =
Yes. Remote users from Fediverse platforms (like Mastodon) can vote on your polls when they can see the poll post.

= Can I also vote on polls in the Fediverse =
Not for now. These feature may come in the feature, when the reader in the ActivityPub plugin is mature.

= Do users need an account on my site to vote? =
No. Both local logged-in users and remote ActivityPub users can participate in polls.

= Where are the votes stored? =
Votes are stored as a custom WordPress comment type, ensuring compatibility with WordPress systems and good performance.

= Will I get notified about poll results? =
Yes. Poll creators and local voters can receive email notifications when results are available.

= Is this plugin suitable for large-scale sites? =
If a persistent object cache is available, it will be used automatically. Polls with up to 1,000 votes should generally perform well.

== Installation ==
1. This plugin depends on the [ActivityPub plugin](https://wordpress.org/plugins/activitypub/). Make sure you have installed and updated it first.

== Screenshots ==
1. Admin UI when editing a poll
2. Overview of all polls in the Admin UI
3. Poll in the Frontend before voting
4. Poll in the Frontend after voting

== Acknowledgement ==

This [project](https://nlnet.nl/project/WP-ActivityPub-polls/) was funded through the [NGI0 Commons Fund](https://nlnet.nl/commonsfund) a fund established by [NLnet](https://nlnet.nl) with financial support from the European Commission's [Next Generation Internet](https://ngi.eu) programme, under the aegis of [DG Communications Networks, Content and Technology](https://commission.europa.eu/about-european-commission/departments-and-executive-agencies/communications-networks-content-and-technology_en) under grant agreement N<sup>o</sup> [101135429](https://cordis.europa.eu/project/id/101135429). Additional funding is made available by the [Swiss State Secretariat for Education, Research and Innovation](https://www.sbfi.admin.ch/sbfi/en/home.html)</a> (SERI).

== Changelog ==
= 1.0.7 =

- Fix: blueprint preview did not install plugin correctly

= 1.0.6 =

- Initial release on WordPress.org
