About this plugin
Social Publisher by Calliope helps WordPress administrators publish from one WordPress dashboard to 10 social networks in Free, with additional destinations available in Pro.
Write the message once, choose the connected destinations, prepare an image, generate titles or captions with Gemini when you want help, and publish from WordPress. The plugin keeps each network connection in its own setup screen, shows clear connected/disconnected states, and keeps provider messages available in Logs when something needs attention.
What you can do in Free
- Publish manually from the dedicated Publisher tab in Social Publisher.
- Publish to multiple connected destinations in one run.
- Use a clean Publisher screen for title, content, link, hashtags, image, alt text, and destination selection.
- Use the built-in image workflow with Original, square, portrait, and landscape formats.
- Connect networks from dedicated setup panels with quick guides, OAuth actions, tests, and disconnect controls.
- Use the optional Gemini-powered AI composer to generate titles, captions, hashtags, or a complete post.
- Search WordPress posts, pages, and WooCommerce products to use as AI context.
- Read, copy, export, and clear sanitized Logs.
- Use a dedicated History tab with permanent destination-by-destination records, search, network/status filters, WordPress source links, account details, media/AI/source badges, provider results, errors, detail panels, and pagination.
- Use Settings for AI keys, model/language preferences, UTM tracking, failure-only email alerts, and plugin data cleanup behavior.
Free network destinations
Social Publisher Free includes connection and publishing support for:
- Bluesky
- Mastodon
- Tumblr
- Threads
- LinkedIn personal profiles
- Blogger
- Telegram
- Facebook Pages
Support depends on each provider’s account type, API permissions, app review status, and platform rules. LinkedIn publishing in this Free release is limited to personal profiles.
Optional Pro destinations
Social Publisher Pro adds these destinations to the same publishing workflow:
- YouTube / Shorts
- Discord
- Remote WordPress
- Custom Webhook
Pro availability, account permissions, privacy options, and media support depend on each provider’s API rules. When Social Publisher Pro supplies a Multiple images / Carousel payload, compatible clients publish the full media set where the provider supports it, including Facebook Pages, Bluesky, Instagram, Threads, Blogger, and Telegram albums.
AI generation
The AI composer is included in the Free plugin. It uses your own Gemini API key, saved locally in your WordPress database. AI runs only when an administrator clicks an AI generation button.
You can:
- Generate a title.
- Generate post content.
- Generate hashtags.
- Generate a complete social post.
- Add a private prompt for the current publication.
- Use WordPress content search as factual context.
- Choose the Gemini model and default generation language in Settings.
Gemini is optional. Social Publisher can connect networks, publish posts, and show logs without a Gemini API key.
Professional workflow
- Open Connections and configure one network.
- Test the connection or complete OAuth when the network provides it.
- Open Settings and connect AI if you want Gemini generation.
- Open Publisher, write or generate the content, prepare media, and choose connected destinations.
- Publish, then review Logs for provider responses and diagnostics.
Platform-specific connection tutorials and video guides are maintained on the CalliopeWP website so setup instructions can stay current without waiting for a plugin release. Visit:
com/calliope-social-publisher/
Privacy and local storage
Provider credentials and tokens are stored locally in the WordPress database for the current site. Do not share them.
Logs and admin messages are designed not to expose full tokens, secrets, authorization codes, passwords, bearer credentials, or API keys. Social Publisher does not track visitors, does not send telemetry, does not display advertising, does not add automatic credits, does not call provider APIs on normal admin page load, and does not execute remote code.
Deleting the plugin preserves saved data by default. If you want WordPress to remove Social Publisher data when the plugin is deleted, enable the cleanup option in Settings before deleting the plugin.
External services
Social Publisher connects to external services only when a site administrator configures a provider, starts authorization, tests a connection, opens a supported share action, requests AI generation, or publishes content.
No data is sent to a provider unless that integration is configured and used.
Google Gemini / Google AI
Used only when a site administrator saves a Gemini API key and clicks an AI generation button.
com/
Data may include the selected Gemini model, site name, default generation language, current title, content, link, hashtags, selected WordPress post/page/product context, per-publication AI prompt, and requested generation field. The Gemini API key is stored locally in the WordPress database.
com/terms
com/privacy
dev/gemini-api/docs
Bluesky
Used for authentication, media upload, and post creation.
social/xrpc/
Data may include the configured handle, app password, post text, link, optional image/media data, and account identifiers.
social/about/support/tos
social/about/support/privacy-policy
Mastodon
Used for OAuth/app registration, account validation, media upload/status checks, and publishing on the administrator-selected Mastodon instance.
Endpoint: the selected public HTTPS Mastodon server.
Data may include the instance host, callback details, OAuth app data, authorization code, client credentials, access token, status text, link, visibility, and optional media files. Localhost, private/reserved IPs, ambiguous hosts, and non-HTTPS instance URLs are rejected.
Terms and privacy policies are published by each Mastodon instance. Examples:
social/terms
social/privacy-policy
Tumblr
Used for OAuth, blog validation, and publishing.
Endpoints:
com/oauth/
com/v2/
Data may include Consumer Key/Secret, OAuth verifier/callback data, token/secret, blog identifier, title/text, link, tags, and optional media data.
com/policy/en/terms-of-service
com/privacy/en
Used for OAuth, board selection, sandbox or production validation, and Pin publishing.
Endpoints:
com/v5/
com/v5/
Data may include App ID/Secret, callback URL, authorization code, requested scopes, token data, Pin title/description, destination link, selected board, and optional image URL/media data.
com/en/terms-of-service
com/terms/
com/en/privacy-policy
Threads
Used for OAuth, token exchange/refresh, account validation, media containers, status checks, and publishing.
Endpoints:
net/oauth/
net/
Data may include App ID/Secret, callback URL, authorization code, scopes, access token data, post text, link, media URL/data, container IDs, and account identifier.
com/terms/dfc_platform_terms/
com/docs/threads/
com/privacy/policy/
Used for OAuth, token exchange, account validation, media containers, and publishing when permissions allow it.
Endpoints:
com/oauth/
com/oauth/
com/
Data may include Client/App ID/Secret, callback URL, authorization code, scopes, token data, caption/text, link when supported, media URL/data, container IDs, and account identifier.
com/terms/dfc_platform_terms/
com/privacy/policy/
Used for OAuth, personal profile detection, validation, image upload preparation/upload, and publishing to a personal profile.
Endpoints:
com/oauth/v2/
com/
Data may include Client ID/Secret, callback URL, authorization code, member scopes, token data, personal profile author URN, post text, link, optional image data, upload URL data, and access token. Company pages and organization publishing are not documented as stable Free destinations in this release.
com/legal/user-agreement
com/api-terms-of-use
com/legal/privacy-policy
Blogger / Google
Used for OAuth, token refresh, blog selection, tests, and publishing to Blogger.
Endpoints:
com/o/oauth2/v2/auth
com/token
com/blogger/v3/
Data may include Client ID/Secret, callback URL, authorization code, Blogger scopes, refresh/access token data, blog ID, post title/content, and labels when used.
com/terms
com/terms
com/privacy
Telegram
Used for bot/chat validation and publishing.
org/
Data may include Bot Token, chat ID, optional message thread/topic ID, post title/text, link, hashtags, and optional image URL/media data.
org/tos
org/bots/api
org/privacy
Facebook Pages
Used for OAuth, Page discovery, Page token resolution, tests, diagnostics, publishing, and the optional public Facebook share action.
Endpoints:
0/dialog/oauth
0/
Data may include App ID/Secret, callback URL, authorization code, scopes, token data, Page identifiers/names, selected Page token, post message, link, optional media data, and the Page URL when using the public share action.
com/terms/dfc_platform_terms/
com/privacy/policy/