=== Aluleth Social ===
Contributors: aluleth
Tags: social media, auto post, schedule posts, bluesky, mastodon
Requires at least: 7.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 0.1.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Plan and publish your social posts from WordPress: a composer, a calendar, posts sent on time, and new posts and products shared on publish.

== Description ==

Aluleth Social publishes your posts on your social accounts from your WordPress admin. Write a post once, give it its own text on a network if you like, and publish it now or plan it on the calendar. When you publish an article, a page or a product, it can be shared on your accounts by itself, a few minutes later.

Everything runs on your site: your posts go straight from your site to each network, with no outside dashboard in between and no fee per post.

**Networks**

* Bluesky (with an app password): text, links made clickable, hashtags, an image with its alternative text, or a link card.
* Mastodon, on any server (with an access token): text, an image with its alternative text, the server's own character limit.
* Telegram: a channel or a group, through your own bot. Text with a link preview, or an image with a caption.
* Discord: a channel, through a webhook. Text, image, and no @everyone pings.
* Webhook: every post sent as JSON to Zapier, Make, n8n or your own code, signed with a secret (HMAC SHA-256).
* One account per network. Aluleth Social Pro adds as many as you need, and more networks.

**The composer**

* One text for every account, and an own text for any account that needs it.
* A character counter for each account, as the network counts it (Bluesky shortens links, Mastodon counts each link as 23 characters).
* A link, with the title and summary of its card, and an image from the media library.
* Publish now, schedule for a date and time, or keep a draft.

**The calendar and the posts**

* A month calendar with every post: planned, published, failed and drafts. Add a post on any day.
* A list of posts with their status on each account, a link to each published post, and what went wrong when a network refused one.
* Edit or cancel a post until it starts, publish a planned post now, try again where it failed, copy a post as a new draft.
* A network that is busy or out of reach is tried again after 5 and 30 minutes. An account whose password or token stopped working is marked, and you see it at once.

**Share on publish**

* Choose what is shared: posts, pages, WooCommerce products, Aluleth Commerce products, FluentCart products.
* A text template for each content type, with {title}, {excerpt}, {url}, {price} and {site}. A text too long for a network is made shorter there.
* The featured image goes with the post.
* An "Aluleth Social" box in the editor turns sharing off for one content or gives it its own text. Each content is shared once.

**Statistics**

* Links to your site get campaign tags (utm_source = the network, utm_medium = social, utm_campaign), so Aluleth Insights and other statistics tools show which network brought each visit and each sale.

**Security**

* Passwords and tokens are kept encrypted in your database and never shown again. They are only sent to the network they belong to.
* Only people with the "Social" access of the Aluleth suite (and administrators) use the screens.

== External services ==

This plugin sends the posts you write, or the contents you choose to share, to the social networks and webhooks you connect yourself. Nothing is sent until you connect an account. Each request goes from your site to the service of that account only.

**Bluesky** (or the server you enter, for an account hosted elsewhere): when you connect the account and each time it publishes, the plugin sends your handle and app password to open a session, then the text, links, image and its alternative text of the post. Service by Bluesky Social PBC: [Terms of service](https://bsky.social/about/support/tos), [Privacy policy](https://bsky.social/about/support/privacy-policy).

**Mastodon**: the server you enter (for example mastodon.social) gets your access token, the text and image of each post, and is asked for its character limit when you connect. Each server has its own terms and privacy policy, shown on its "About" page (for example [mastodon.social/about](https://mastodon.social/about)).

**Telegram**: the Telegram Bot API (api.telegram.org) gets your bot token, the chat you choose, and the text and image of each post. Service by Telegram: [Terms of service](https://telegram.org/tos), [Privacy policy](https://telegram.org/privacy).

**Discord**: the webhook address you paste (discord.com) gets the text and image of each post, and is read when you connect to show its channel. Service by Discord Inc.: [Terms of service](https://discord.com/terms), [Privacy policy](https://discord.com/privacy).

**Webhook**: the address you enter gets each post as JSON (text, link, image address, the account's name), and a test message when you connect. It is your own service or the one you chose (Zapier, Make, n8n…): its terms and privacy policy apply.

== Installation ==

1. Install and activate the plugin.
2. Go to Aluleth › Social › Accounts and connect a first account. Each network says where to find what it needs.
3. Write a post in New post, or plan it on the Calendar.
4. To share your new contents by themselves, choose them in Settings › Share on publish.

== Frequently Asked Questions ==

= Why not Facebook, Instagram, LinkedIn or X? =

These networks only let a site publish through a developer app of its own, made on their developer pages. Aluleth Social Pro connects Facebook Pages, Instagram, Threads, LinkedIn, X and Pinterest through your own app. Without Pro, the Webhook account can hand your posts to Zapier, Make or n8n, which reach these networks.

= Are scheduled posts sent on time? =

They go out with the WordPress scheduler, which runs when someone visits your site. On a quiet site, or when your host turned the scheduler off, ask your host for a server task that calls wp-cron.php every minute: posts then go out at the minute.

= Does it post the same text everywhere? =

By default yes, and each account can get its own text. Links to your site get campaign tags for your statistics.

= Where are my passwords kept? =

Encrypted in your database, with a key made from your site's own secret keys (wp-config.php). They are never shown again in the admin. Use an app password (Bluesky), a token you can withdraw (Mastodon, Telegram) or a webhook you can delete (Discord) rather than your main password.

= Which languages? =

English and French.

= What happens when I delete the plugin? =

Your posts and accounts stay, unless you tick "Aluleth Social" under Aluleth › Settings › Delete on uninstall. What was published on the networks stays there.

== Changelog ==

= 0.1.2 =
* Two filters for Aluleth Social Pro's approval: aluleth_social/settings_refused refuses a save of Social › Settings with a message (nothing stored changes), and aluleth_social/settings_locked shows those settings read-only with an explanation. A third one, aluleth_social/box_locked, keeps the own text of the editor box read-only (turning the share off stays possible).

= 0.1.1 =
* Shared Aluleth core 0.19.0: Aluleth Social uses only the Aluleth menu, Settings › Access and Settings › Data and privacy. Contacts, Import, the Dashboard of contacts, Connections and the spam settings of forms are no longer shown, the shared contact tables are not created, and their outside services cannot be reached. They come back only when another Aluleth plugin that uses them is active.

= 0.1.0 =
* First version: Bluesky, Mastodon, Telegram, Discord and webhooks, composer with an own text for each account, calendar, scheduled posts with retries, share on publish for posts, pages and products, campaign tags, French.
