=== Coug Latest Posts for Patreon ===
Contributors: Coug
Tags: patreon, creators, shortcode, membership
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display your latest Patreon posts on WordPress with teaser images, including support for adult and NSFW creators.

== Description ==

Coug Latest Posts for Patreon connects a Patreon creator account to WordPress and automatically displays the creator's latest Patreon publications.

The plugin is especially suited to creators who use a public teaser image before locked or premium content, including adult/NSFW Patreon creators.

Features:

* Display the latest Patreon posts with a shortcode.
* Show or hide the teaser image, title and Patreon button.
* Responsive card layout.
* Configurable automatic refresh and local caching.
* Guided Patreon API configuration.
* Public fallback card when no usable teaser image is available.
* Native WordPress internationalization, ready for WordPress.org language packs.
* Patreon credentials stay on the WordPress installation and are never sent to the plugin author.

The plugin does not bypass Patreon access restrictions or unlock premium content.

== Languages ==

English (US) is the source language. The plugin is fully internationalized using the native WordPress gettext system.

Translations for the WordPress.org release are managed and distributed through translate.wordpress.org and WordPress language packs rather than bundled .po/.mo files.

== Preview images ==

The plugin uses the first usable image inserted into the free/public part of the Patreon post text as the WordPress preview image.

Images that exist only in Patreon galleries, attachments, or locked premium content are not imported as thumbnails.

For adult/NSFW creators, the recommended workflow is:

1. Add a SFW or soft teaser image in the public/free section of the Patreon post.
2. Keep explicit or premium content inside the locked Patreon section.
3. The plugin displays the public teaser and links the visitor to Patreon.

If no usable public teaser image is found, the plugin displays its fallback card.

== Installation ==

1. In WordPress, go to Plugins > Add New > Upload Plugin.
2. Upload and activate Coug Latest Posts for Patreon.
3. Open the Coug Patreon menu in the WordPress admin.
4. Follow the User Guide to create a Patreon API client and enter your credentials.
5. Click Test Patreon to verify the connection.
6. Add `[couglapo_latest_patreon]` to a page, post, or shortcode-compatible widget.

== Shortcodes ==

`[couglapo_latest_patreon]`

Displays the latest 3 Patreon posts.

`[couglapo_latest_patreon count="1"]`

Displays only the latest Patreon post.

`[couglapo_latest_patreon count="6"]`

Displays up to 6 cached Patreon posts.

== Screenshots ==

1. Responsive Patreon post cards on the WordPress front end, with public teaser images and the built-in 18+ NSFW fallback.
2. Patreon connection and status dashboard, with the Client ID hidden for privacy. Secret credentials are never rendered back after saving.
3. Display settings for the button, fallback image, visible elements and automatic refresh frequency.
4. Built-in user guide covering Patreon connection, thumbnail selection, shortcodes, caching and troubleshooting.

== Frequently Asked Questions ==

= Does this plugin bypass Patreon paywalls? =

No. It does not unlock, reproduce, or bypass locked Patreon content.

= Where does the thumbnail come from? =

The plugin uses the first usable image inserted into the free/public part of the Patreon post text.

= Why do I see the fallback instead of an image? =

Check that the post contains an image directly in its free/public text section. Images stored only in a gallery, attachment area, or locked content may not be available as a public preview.

= Does it support adult/NSFW Patreon creators? =

Yes. The plugin can be used by adult/NSFW creators. Use a public teaser image that you are comfortable displaying on your WordPress site and keep premium or explicit material locked on Patreon.

= Do I share my Patreon credentials with Coug? =

No. Your credentials remain on your WordPress installation. The plugin author does not receive them.

= How are Patreon credentials stored? =

Client Secret, Creator Access Token and Creator Refresh Token are stored server-side in a dedicated non-autoloaded WordPress option. They are not rendered back into the settings page after saving. The plugin does not encrypt them in the WordPress database, so database access must be protected.

== External services ==

This plugin connects directly to Patreon because Patreon is the service that provides the creator posts displayed by the plugin.

The plugin may contact:

* Patreon API endpoints to retrieve the authenticated creator's campaign and posts.
* Public Patreon post pages when a public preview needs to be detected.
* Patreon-owned media hosts to download a public teaser image into the local WordPress upload directory.

The Patreon API credentials entered by the administrator are sent only to Patreon as required for authentication. They are not sent to Coug or to servers controlled by the plugin author.

No visitor account data is sent to the plugin author.

This plugin is an independent project and is not affiliated with or endorsed by Patreon.

Patreon API documentation: https://docs.patreon.com/
Patreon policies and terms: https://www.patreon.com/policy
Patreon privacy policy: https://privacy.patreon.com/

== Support Development ==

If this plugin is useful to you and you would like to support its continued development, you can buy me a coffee:

https://ko-fi.com/cougai

== Changelog ==

= 1.2.0 =
* Finalized the WordPress.org review compliance pass.
* Hardened one-time migration of legacy settings and Patreon credentials.
* Preserved OAuth credential values without text-field mutation.
* Kept CSS loading on WordPress enqueue APIs with unique plugin prefixes.
* Kept WordPress.org translation distribution through language packs.
* Added and documented the optional Ko-fi support link.
* Declared compatibility through WordPress 7.1.

= 1.1.1 =
* Restored automatic migration of settings and Patreon credentials from legacy development builds to the new prefixed storage keys.
* Legacy values are preserved and are not deleted during migration.


= 1.1.0 =
* Added a discreet author/support footer to all plugin administration tabs.
* Added an optional Ko-fi support link.
* Applied the WordPress.org review compliance updates for asset loading, unique prefixes, settings sanitization and translation distribution.


= 1.0.0 =
* First public release.
* Patreon API v2 connection.
* Latest-post display with responsive cards.
* Public teaser image system and fallback.
* Configurable image, title, button and refresh settings.
* Local caching.
* Native WordPress gettext internationalization.
* WordPress.org language-pack compatible internationalization.
* Security hardening for credentials and remote media.
