Calliope Social Publisher - Social Publishing Plugin Guide
Calliope Social PublisherBy Calliope
Social Publishing Plugin
Publish to the social web from WordPress.
Calliope Social Publisher removes the friction of social publishing. Instead of juggling multiple browser tabs or relying on fragile third-party bridges, connect your accounts directly to your site through a clean, guided workflow built for serious businesses.
Designed for non-technical users and professional content teams
Built for real business workflows.
Calliope Social Publisher bridges the gap between WordPress and the social networks your audience actually uses. It is engineered specifically for site owners, content teams, and agencies who need reliable connections without the guesswork of navigating complex developer portals alone.
Direct API Connections
Centralize your social connections securely within your own server. No middleman bridging services storing your data.
Beginner-Friendly Flow
We translate complex developer terminology into plain English, ensuring you copy the right keys into the right places.
Integrated Guidance
The plugin features built-in setup instructions and clear error states to keep your workflow moving forward.
Granular WP Control
Manage authorizations, default posting behaviors, and connection status directly from your WordPress dashboard.
Organizational Accuracy
Engineered for real organizational workflows, supporting precise Facebook Page and Pinterest Board selections.
Natively Supported Networks
Official Connection Guide
We explain technical terms in simple language. Whenever you see a Redirect URI, Client ID, or App Secret, always copy and paste exactly. Do not type them by hand.
Getting Started with Calliope Social Publisher
1
Download and Install
Download the official Calliope Social Publisher ZIP package from the direct download link. Upload it to your WordPress plugins area, or include it in your normal deployment workflow.
2
Activate the Plugin
Click Activate. Once activated, the Calliope Social Publisher icon and menu will appear in your main WordPress administrative sidebar.
3
Open Settings
Navigate to Calliope Social Publisher > Settings in your dashboard to view the grid of available social networks.
4
Choose a Network
Select the specific social network you want to connect first. You do not need to connect all of them at once.
5
Follow the Setup Guide
Switch to the Social Connections tab at the top of this guide block to find the exact, step-by-step connection instructions for your chosen platform.
Implementation Tip
You only need to set up the networks you actively plan to use for your business. Calliope Social Publisher keeps the interface clean by hiding settings for networks you have not connected yet. You can always return later and add more platforms.
Select Platform
Connecting Bluesky
Use this connection so Calliope Social Publisher can publish to your Bluesky account. The setup is short and beginner-friendly, but there is one key detail: you must use an App Password created inside Bluesky, not your normal login password.
What you will need
A Bluesky account
Your Bluesky handle, for example yourname.bsky.social
Access to your Bluesky settings while Calliope Social Publisher is open in another tab
Keep in mind
An App Password is a special password created for apps.
Never paste your normal Bluesky password into Calliope Social Publisher.
Copy the handle and the App Password exactly as Bluesky shows them.
Warning
A Bluesky App Password is not the same as your main Bluesky password. Calliope Social Publisher should only receive the App Password you create inside your Bluesky settings.
Step-by-Step Configuration
1Create or confirm your Bluesky account
Open bsky.app and sign in to your Bluesky account. If you do not have one yet, create it first. Keep it open because in the next step you will create a special password.
Inside Bluesky, open Privacy & Security and create a new App Password. This is the secure password made for external tools like Calliope Social Publisher. Copy it as soon as Bluesky shows it, because that exact value is what you will paste into Calliope Social Publisher.
Important: you do not need to create a developer app for Bluesky. This step is done directly inside your account settings.
B1 — Open Privacy & Security in Bluesky and enter App Passwords.B2 — Create a new App Password and copy it carefully.
Do not paste your normal Bluesky login password into Calliope Social Publisher. Paste only the new App Password created on this screen.
3Paste your details into Calliope Social Publisher and test the connection
Go back to Calliope Social Publisher and enter your Bluesky handle and the App Password you just copied. Your handle is the public account name, for example yourname.bsky.social. Then click Save and test.
B3 — Enter the handle and the App Password in Calliope Social Publisher, then run Save and test.
It is connected when...
It is connected when the Bluesky status inside Calliope Social Publisher changes to Connected or shows a successful test result.
Connecting Mastodon
Calliope Social Publisher connects to Mastodon through your server and a simple approval screen. The most important thing is understanding what the server is: it is the second part of your Mastodon address.
What you will need
A Mastodon account
The server part of your address
Permission to approve the connection in your browser
Keep in mind
If your account is @[email protected], the server is mastodon.social.
Type only the server name, not the full address @name@server.
You must approve the permissions screen for publishing to work.
Helpful tip
A server is the main website where your Mastodon account lives. Example: if your account is @[email protected], your server is mastodon.social.
Step-by-Step Configuration
1Create or open your Mastodon account
Make sure you already have a Mastodon account and that you can sign in. If you are new to Mastodon, create your account first and note the full address you use there.
2Enter only your server name in Calliope Social Publisher
In Calliope Social Publisher, type only the server part of your Mastodon address. Do not include your username, the @ symbol, or any extra text. Save the settings after entering the server.
M1 — Enter only the Mastodon server name, not the full account address.
3Connect and approve access
Click Connect with Mastodon. Mastodon will open a permissions page so you can approve the connection. Allow access, return to Calliope Social Publisher, and confirm that your account now appears connected for publishing.
M2 — Approve the permissions request and then return to Calliope Social Publisher.
It is connected when...
It is connected when Calliope Social Publisher shows Mastodon as connected and ready to publish.
Connecting Tumblr
Calliope Social Publisher needs a small app setup before it can connect to Tumblr. Do not worry: most of the work is simply copying the correct values from Tumblr into Calliope Social Publisher.
What you will need
A Tumblr account and blog
Your Blog Identifier
A Callback URL copied exactly from Calliope Social Publisher
Keep in mind
Your Blog Identifier is usually just the host of your blog, for example yourblog.tumblr.com.
The Callback URL and the OAuth Redirect URL must match exactly.
Tumblr may ask for app icons during setup.
Important
In Tumblr, Blog Identifier means only your blog address, such as yourblog.tumblr.com. It is not your email address, a sentence, or a nickname.
Step-by-Step Configuration
1Confirm your Tumblr blog and enter the Blog Identifier
Open Tumblr and make sure you know which blog you want to connect. In Calliope Social Publisher, enter the Blog Identifier using only the host of your blog, such as yourblog.tumblr.com.
T1 — Enter the Blog Identifier exactly as your blog host.
2Create a Tumblr app
Go to tumblr.com/oauth/register and create a new app. Fill in the required basic fields such as the app name, website, description, and administrator contact email.
T2 — Complete the Tumblr app form with the required details.
3Paste the exact callback address and copy the keys
When Tumblr asks for the Callback URL and OAuth Redirect URL, paste the exact address provided by Calliope Social Publisher. Do not type it by hand. After saving the app, copy the OAuth Consumer Key and OAuth Consumer Secret into Calliope Social Publisher and save your changes.
Exact Callback URL and OAuth Redirect URLhttps://yourdomain/wp-admin/admin-post.php?action=sh_tumblr_oauth_callback
Warning
Copy the redirect address exactly. Even one missing character can stop Tumblr from returning to Calliope Social Publisher.
4Connect with Tumblr and allow access
Click Connect with Tumblr inside Calliope Social Publisher. Tumblr will ask for permission to access your account. Approve the request and return to Calliope Social Publisher to finish the setup.
T3 — Allow the Tumblr permissions request.T4 — Calliope Social Publisher shows the Tumblr connection after approval.
It is connected when...
It is connected when Tumblr appears as connected inside Calliope Social Publisher and the permissions step has already been approved.
Connecting Pinterest
Pinterest needs more preparation than the other networks because the app often starts in a limited review state. Follow the steps calmly and keep in mind that the approval process can take time.
What you need
A Pinterest Business account
A Pinterest app in the developer dashboard
Your App ID, App Secret, token, and Board ID
Keep in mind
Pinterest app approval can take days after Pinterest contacts you by email.
The Redirect URI must be copied exactly from Calliope Social Publisher.
Production posting usually requires Standard Access, not only trial access.
Warning
Pinterest app approval can take days. Do not expect production publishing to work immediately after creating the app.
Important
For real production posting, Pinterest usually requires Standard Access. Trial access often lets you connect, but not publish.
Step-by-Step Configuration
1Create your Pinterest app
Open the Pinterest developer area and create a new app. Complete the required fields, such as app name, company name, website, privacy policy, purpose, use cases, and audience.
P1 — Complete the Pinterest app form and the required business details.
2Wait for approval before continuing
After creating the app, Pinterest may leave it pending until it reviews the request or contacts you by email. That is normal. Wait until the app is approved enough to continue with the next steps.
3Add the exact Redirect URI and paste the app details into Calliope Social Publisher
Once the app is approved, paste into Pinterest the exact Redirect URI shown by Calliope Social Publisher. Then copy your App ID and App Secret into Calliope Social Publisher. If your setup requires a token, generate it and paste it too, then save the configuration.
Do not guess the Redirect URI and do not skip saving. Pinterest is strict about exact callback details.
P2 — Add the Pinterest credentials in Calliope Social Publisher, save, detect the board, and connect.
4Detect the Board ID and connect
Before you try to finish the connection, click Detect Board ID inside Calliope Social Publisher if that button is available. After that, click Connect with Pinterest. This extra step matters because Calliope Social Publisher needs to know which board it should use.
It is connected when…
It is connected when Calliope Social Publisher saves the Pinterest connection correctly and your correct board has been detected or selected.
Connecting Threads
Threads uses Meta’s developer system, so the setup has a few extra parts. The good news is that each one has a simple purpose: create the Meta app, enable the correct permissions, add a tester account, and then connect.
What you need
Access to Meta Developers
The correct Business Portfolio
Your Threads account ready to be added as a tester
Keep in mind
A Business Portfolio is the Meta workspace that owns the app.
The app needs the Threads API product and the correct permissions.
The tester invitation must be accepted before the connection can work.
Important
Permissions are simply the approvals Meta needs before Calliope Social Publisher can read your Threads account and publish for you. In this setup, the important ones are threads_basic and threads_content_publish.
Step-by-Step Configuration
1Create a Meta app for Threads
Go to Meta Developers and create a new app. During setup, choose the correct Business Portfolio. If you do not have the right business workspace yet, create it first and then continue.
TH1 — Start a new Meta app for the Threads connection.TH2 — Choose the business workspace that should own the app.TH3 — Use the correct Business Portfolio or create one if needed.
2Add the Threads API product and confirm the app
Inside the Meta app, add the Threads API product and complete the basic confirmation screens. This tells Meta what kind of connection you are creating.
TH4 — Add and confirm the Threads setup inside the Meta app.
3Enable the required permissions and paste the Redirect URI
In the Threads settings, enable threads_basic and threads_content_publish. Then paste the exact Redirect URI shown by Calliope Social Publisher. This is the return link that sends you back to Calliope Social Publisher after approval, so it must match exactly.
Example Redirect URI format https://yourdomain/wp-admin/admin-post.php
Warning
Copy the Redirect URI exactly as it appears. A small mistake can break the return step and leave the connection unfinished.
TH5 — Enable the required Threads permissions and add the Redirect URI.
4Add a privacy policy, publish the app, and add your Threads tester
Before connecting, add a valid privacy policy in the app settings and switch the app to active or published when Meta requires it. Then open Roles, add your Threads account as a tester, and accept the invitation in Threads website permissions.
Adding the tester alone is not enough. The tester account must also accept the invitation, otherwise Calliope Social Publisher cannot finish the connection.
TH6 — Add the privacy policy and prepare the app for publishing.TH7 — Add the Threads tester and then connect from Calliope Social Publisher.
5Connect from Calliope Social Publisher
Go back to Calliope Social Publisher, enter the Threads App ID and Threads App Secret if needed, save the configuration, and click Connect with Threads. Approve the flow and return to Calliope Social Publisher.
TH8 — Calliope Social Publisher shows the Threads connection after the approval flow is complete.
It is connected when…
It is connected when Calliope Social Publisher returns correctly from Meta and the Threads account appears as connected.
Connecting Instagram
Instagram also uses Meta, but this setup is specifically designed for a business or professional connection flow. Move slowly and pay close attention to the Business Login settings and the Redirect URI.
What you will need
Access to Meta Developers
The correct Business Portfolio
An Instagram business or professional account that can be connected through Meta
Keep in mind
This connection usually depends on an Instagram business or professional setup, not on a basic personal account.
The Business Login Redirect URI must be copied exactly.
You may need tester access before the connection can be completed.
Important
In Instagram, the Redirect URI is the return address that sends Meta back to Calliope Social Publisher. Paste it exactly as Calliope Social Publisher shows it, character by character.
Step-by-Step Configuration
1Create a Meta app using the Business path
Open Meta Developers and create a new app. Choose the Other use case and then select the Business app type. When Meta asks for a Business Portfolio, choose the correct one for the account you want to connect.
IG1 — Start the Meta app and choose the correct use case.IG2 — Choose the Business app type.IG3 — Select the Business Portfolio that should own this app.
2Add the Instagram product to the app
After creating the app, add the Instagram product or the Instagram login flow shown inside your Meta dashboard. Continue through the product setup screens until the Instagram connection settings are available.
IG4 — Add the Instagram product to the Meta app.IG5 — Continue through the Instagram product setup screens.
3Paste the Business Login Redirect URI exactly
Open the Business Login settings and find the OAuth Redirect URIs field. Paste the exact callback address shown by Calliope Social Publisher. Do not change it, shorten it, or add extra characters.
Do not type the Redirect URI from memory. Copy and paste it exactly. This is one of the most common reasons an Instagram connection fails.
4Add a privacy policy, activate the app, and accept tester access
Add a valid privacy policy in the app basic settings. When Meta requires it, switch the app to active or live mode. Then add your Instagram account as a tester and accept the invitation from the Instagram access screen before you continue.
IG6 — Accept tester access and make sure the app setup is ready.
5Enter the app details in Calliope Social Publisher and connect
Paste the App ID and App Secret into Calliope Social Publisher, click Save & Test, and then click Connect with Instagram. Approve the connection flow and return to Calliope Social Publisher.
IG7 — Paste the Instagram app details into Calliope Social Publisher and start the connection.IG8 — Calliope Social Publisher shows the Instagram connection after approval.
It is connected when...
It is connected when Calliope Social Publisher returns from Meta and your Instagram account appears as connected and ready to use.
Connecting LinkedIn
LinkedIn is one of the simplest setups. Create a LinkedIn app, add the exact Redirect URI, paste the client details into Calliope Social Publisher, and approve the connection.
What you will need
Access to LinkedIn Developers
Your Client ID and Client Secret
The exact Redirect URI shown inside Calliope Social Publisher
Keep in mind
This Calliope Social Publisher connection is for personal LinkedIn profiles only.
This version does not publish to company pages.
The Redirect URI must be added in LinkedIn exactly as Calliope Social Publisher shows it.
Warning
This LinkedIn connection is only for personal profiles. It does not publish to company pages or business pages inside Calliope Social Publisher.
Step-by-Step Configuration
1 Create a LinkedIn app and open the Auth settings
Open LinkedIn Developers, create your app, and go into the Auth section. That is where LinkedIn shows the client details and where you add the authorized return address.
LI1 — Create the LinkedIn app, copy the client details, and add the Redirect URI.
2 Copy the Client ID and Client Secret, then add the Redirect URI
Copy the Client ID and Client Secret from LinkedIn into Calliope Social Publisher. Then copy the Redirect URI from Calliope Social Publisher and paste that exact same address into the authorized redirect URLs inside LinkedIn.
Common error
The redirect address must match in both places: Calliope Social Publisher and LinkedIn. If they are different, even slightly, the approval flow will fail.
3 Save, connect, and approve
Save the settings in Calliope Social Publisher first so the client details are stored. Then click Connect with LinkedIn and approve the access request in LinkedIn. If Calliope Social Publisher shows a button such as Use connected profile, select it so the correct personal profile is filled in automatically.
You are connected when…
Calliope Social Publisher returns from LinkedIn and shows your personal profile as the connected destination.
Connecting Blogger
Blogger uses Google Cloud Console, which can look technical at first. In practice, you only need to create a project, enable the Blogger API, create a web credential, paste the Redirect URI, and then connect with Google.
What you will need
Access to Google Cloud Console
A Google account with access to the Blogger blog
The exact Blogger Redirect URI shown by Calliope Social Publisher
Keep in mind
Google Cloud Console may ask you to configure the consent screen before the client can be used.
The application type must be Web application.
If Google requires it, switch the app to production before connecting.
Important
The Redirect URI in Google Cloud must exactly match the one provided by Calliope Social Publisher. Also, make sure you enable the Blogger API in the Library, or the connection will fail.
Step-by-Step Configuration
1 Create a new Google Cloud Project
Go to the Google Cloud Console, log in with the same Google account that owns the blog, and create a new project. Give it a name you will remember, like Calliope Social Publisher Blogger Connection.
Inside your new project, navigate to "APIs & Services" > "Library". Search for "Blogger API v3" and click Enable. Without this, Calliope Social Publisher won't be allowed to post.
3 Setup OAuth Consent Screen
Go to "OAuth consent screen" in the menu. Choose "External" and click Create. Fill in the required fields (App name, User support email, and Developer contact information). Save and continue through the remaining steps.
Note: Once completed, you may need to click "Publish App" so it changes from Testing to In Production.
4 Create Credentials and Add Redirect URI
Navigate to "Credentials" > "Create Credentials" > "OAuth client ID". Choose "Web application" as the Application type. Under "Authorized redirect URIs", paste the exact Callback URL given by Calliope Social Publisher.
Be very precise. If you add a trailing slash in Calliope Social Publisher but omit it in Google Cloud, the connection will fail.
5 Enter details in Calliope Social Publisher and Connect
Copy the Client ID and Client Secret from Google Cloud into Calliope Social Publisher. Save your settings, and click "Connect with Blogger". You'll be asked to log in to Google and grant access. After you return, select the Blog you wish to post to.
It is connected when...
It is connected when Calliope Social Publisher returns from Google, displays your Google account as connected, and your target blog is successfully selected.
Connecting Facebook
Facebook also uses Meta, but the final destination is a Facebook Page. The key idea is simple: create the right Meta app type, give it the Page permissions it needs, connect your Facebook account, and choose the correct Page.
What you will need
Access to Meta Developers
The correct Business Portfolio
Access to the Facebook Page you want to publish to
Keep in mind
Permissions are the approvals that let Calliope Social Publisher see your Pages and publish to the one you select.
The correct business workspace and Page roles do matter.
You must choose the Page after the Facebook approval flow.
Important
If Calliope Social Publisher cannot find your Facebook Pages, the most common causes are missing Page permissions, the wrong Business Portfolio, or not having the correct role on the Page.
Step-by-Step Configuration
1Create the Meta app for Facebook Pages
Go to Meta Developers and create a new app. Choose the use case that manages all aspects of your Page and then continue through the setup screens.
FB1 - Choose the Facebook Page management use case when creating the app.
2Use the correct Business Portfolio and enable Page permissions
When Meta asks for the Business Portfolio, select the one that owns or manages the Page you will use. If the dashboard asks for permissions, enable the ones needed for Page access and publishing, such as pages_show_list, pages_read_engagement, pages_manage_posts, and pages_manage_metadata.
FB2 - Add the required Page permissions in the Meta app.FB3 - Continue the Facebook app configuration with the Page permissions enabled.FB4 - Make sure the correct Business Portfolio is selected.
3Add the exact Redirect URI and the privacy policy
Copy the Facebook Redirect URI from Calliope Social Publisher and paste it into the Meta app exactly as shown. Also add a valid privacy policy in the basic app settings and publish the app when Meta requires it. Paste the exact Redirect URI that Calliope Social Publisher shows you. Do not type it by hand.
Do not skip the privacy policy or publication step when Meta requires them. The connection may appear to start correctly and still fail before you can choose the Page.
FB5 - Complete the Meta app configuration before the connection flow.FB6 - Add the Redirect URI exactly as Calliope Social Publisher shows it.
4Paste the App ID and App Secret into Calliope Social Publisher
Copy the Facebook App ID and the App Secret from Meta into Calliope Social Publisher and save the configuration. This stores the app details before the connection flow starts.
5Connect Facebook and choose the correct Page
Click Connect with Facebook inside Calliope Social Publisher and follow Meta's approval screens. When Facebook shows your available Pages, choose the one you want Calliope Social Publisher to use. This final selection matters because Calliope Social Publisher can only publish to the Page you choose there.
Common error
Choosing the wrong Page is a very common mistake, especially when the same Facebook account manages several Pages.
It is connected when...
It is connected when Calliope Social Publisher shows the selected Facebook Page as the connected publishing destination.
