Refract

You already write on your blog. With Refract, you don't have to write the same thing again for every network. When you publish a post, Refract gets it as a note. It writes a version for each account you chose, in your workspace's voice, and crops the post's images for each network. Every version waits for your approval. You preview and approve the versions in the post editor, or in Refract. Nothing goes out until you approve it. Bring readers back from social Each version links back to your post, so your blog gets visits and your links get shared. Once a version is posted, the post editor shows the link to it and the clicks so far, for example "12 clicks from Instagram". From WordPress to Refract

• Send posts when they're published, or only when you choose, from the editor.
• Choose the post types, the categories and the accounts.
• See each version in the post sidebar: its text, its image in the network's shape and its status.
• Approve each version, or approve all and add them to the queue. Or open one in Refract to edit it.
• Works with the block editor and the Classic Editor plugin.

From Refract to WordPress Your site becomes an account in Refract. From Refract you can send blog posts to it as drafts, or, if you allow it, publish or schedule them. Refract can create posts, update the posts it created and move them to the trash. It can't change anything else on your site: not other posts, settings, users, plugins, themes or files. It's off until you turn it on, and then sends drafts only unless you choose otherwise. You choose which user the posts show as their author (Refract never signs in as that user) and the default category. You can turn this off at any time. Link previews The plugin can add social preview tags (Open Graph and X card), so your links show a title and an image on every network. If another plugin already adds these tags, the plugin leaves them to it. Networks Networks you can connect: TikTok, YouTube, X, Pinterest, Bluesky, Mastodon, Telegram, Discord, Tumblr, Slack, Pixelfed and DEV. Coming soon: Instagram, Facebook and Threads. What you need

• A Refract account. You can start with a free trial at refract.social, no card needed.
• AI credits for the versions. Each version costs 1 AI credit, and your plan includes credits each month. With your own AI key in Refract, versions cost no credits. You can also send the same post, with the link, to every account for free.
• WordPress 6.8 or later and PHP 8.1 or later. Multisite works: each site connects separately.

Source code The JavaScript in build/ is made with @wordpress/scripts. Its unminified source is in the plugin's src/ folder, and the build setup is in package.json and webpack.config.js. To build it yourself, run npm install and then npm run build in the plugin's folder. The source code is also on GitHub: anpsthemes-wp-themes/refract-for-wordpress. The network icons in src/common/marks.js come from Simple Icons (CC0 1.0). The Refract and LinkedIn marks are drawn for this plugin.

1. In WordPress, go to Plugins › Add New, search for "Refract" and click Install, then Activate. Or upload the plugin's folder to /wp-content/plugins/ and activate it on the Plugins screen.
2. Go to Refract › Settings and click "Connect to Refract". Sign in to Refract, or start a free trial, and allow the connection.
3. Choose the workspace, the accounts that get a version of each post, and when to send posts to Refract. Click Save.

If the redirect back to your site doesn't work, for example on a local site or a site behind a login, open "Connect with a token instead". Create a token in Refract under Settings › API and agents, and paste it there.

1.2.1

• Publishing from Refract never acts as a user on your site. The "Publish as" person is only shown as the author, and what they can do is checked before anything changes.
• Publishing from Refract sends drafts only until you choose "Publish and schedule posts".
• The settings page says exactly what Refract can and can't do on your site.

1.2.0

• A clearer Settings page: the connection at the top, a section for each part (Sending, Accounts, Writing and images, Publishing from Refract, Link previews) with a summary of what's chosen, and links to jump between them.
• Choices are cards that say what each one does, and which ones use AI credits or are free.
• Accounts show as cards by network, with how many are chosen and Select all or Select none. Pick categories by searching for them.
• Save changes stays in view while you have unsaved changes, with Discard changes. Leaving the page asks first.
• Settings and Activity are tabs at the top of both pages.

1.1.0

• Refract can remove a post it published on your site: when you remove the post in Refract, it moves to the trash here.

1.0.0

• First release: connect your site, send posts to Refract, preview and approve the versions in the editor, publish from Refract to your site, social preview tags and the Activity log.