=== MBX Flow ===
Contributors: darioti
Tags: social media, auto share, publish, blog, scheduling
Requires at least: 6.3
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 2.0.6
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Connect this site to your MBX Flow workspace: new articles are shared to your social accounts, and MBX Flow can publish entries on this blog.

== Description ==

MBX Flow is social publishing for brands and artists: one place to write, schedule and publish to your social accounts. This plugin connects a WordPress site to your workspace, and works both ways.

* **Share new articles.** When an article is published, its title, excerpt, link, featured image and tags go to MBX Flow, which writes a social post and schedules it to the accounts you chose: right away, or at the time MBX Flow picks. Each article's editor has an MBX Flow box to change the accounts and timing for that one, or to keep it off the networks.
* **Publish from MBX Flow.** A post you send to your WordPress account from MBX Flow becomes an entry on this blog, with its first line as the title, its image as the featured image and its hashtags as tags. You choose whether it is published or left as a draft for you, in which category, and under which author.

Connecting takes one code. In MBX Flow you press Get a connect code; you paste it here and press Connect. There is no address to copy and no password to type, and the code works once. The token the plugin keeps reaches only its own two endpoints; MBX Flow cannot log in to this site or read anything else.

You need an MBX Flow account to use it: https://mbxflow.com/

== External services ==

This plugin talks to **your MBX Flow workspace**, the social publishing service operated by MediaBoxEnt Technologies. When you connect, it sends the connect code to https://mbxflow.com/api/wp-connect, which answers with the address of the workspace that issued the code, and nothing else; it then sends that workspace the site's address and name. For each article you share, it sends that article's title, excerpt, link, featured image address and tags, with the accounts and timing you chose. It reads back the list of accounts connected in your workspace (names and networks only). Nothing is sent for an article you do not share. When MBX Flow publishes to this site, the request comes from your workspace to this plugin's endpoint, carrying the entry's title, body, image address and tags.

* Terms of Service: https://mbxflow.com/legal/terms
* Privacy Policy: https://mbxflow.com/legal/privacy

© 2026 MediaBoxEnt Digital Studio LLC. MBX Flow™ is a product of MediaBoxEnt Technologies.

== Installation ==

1. Install and activate the plugin.
2. In MBX Flow, open Automation → WordPress and press Get a connect code.
3. Open MBX Flow in the WordPress admin menu, paste the code and press Connect.
4. Choose which accounts new articles are shared to and when, and how entries coming from MBX Flow are created.

== Frequently Asked Questions ==

= Does MBX Flow get a password for my site? =

No. Connecting hands the plugin one token that works only on the plugin's own endpoints: reading the site's name and version, and creating an entry the way you configured. It cannot log in, edit other content or read your users.

= Can an entry MBX Flow publishes here get shared back out? =

No. Every entry created from MBX Flow is marked, and marked entries are never shared, so a post cannot go round in a loop.

= Which articles are shared? =

Posts, when published for the first time, if "Share when published" is on for them. The default is on the plugin's MBX Flow page; each article's editor has an MBX Flow box to change it. Updating an already published article does not share it again. Other post types can be added with the `mbxflow_post_types` filter.

= Can I turn the AI off? =

Yes, both parts of it, on the plugin's MBX Flow page and per article in the editor's MBX Flow box. "Write the post with AI" off means the social post is the article's title, excerpt and link, with its tags as hashtags, and no AI is used. "Post now" means it goes out as soon as the article is published; "best time (AI)" lets MBX Flow choose the slot.

= When does the share happen? =

About a minute after publishing. The share is queued so that the choices in the article's MBX Flow box are saved before it is sent. The box then shows "Shared on MBX Flow" with the time the social post is scheduled for.

= Sharing says it needs the Pro plan =

Sharing new articles is part of the MBX Flow Pro plan, like RSS → Social. Publishing from MBX Flow to this blog works on every plan.

= How do I disconnect? =

MBX Flow (admin menu) → Disconnect. The token is deleted here; you can also delete the WordPress account in MBX Flow under Accounts. Deleting the plugin removes its settings; the entries it created stay.

== Screenshots ==

1. The MBX Flow page: connection, sharing defaults and how entries from MBX Flow are created.
2. The MBX Flow box in the article editor.

== Changelog ==

= 2.0.6 =
* Sites in any variant of Spanish, French, German or Italian (for example Spanish from Argentina or Mexico, French from Canada, German from Switzerland) see the plugin in their language instead of English.

= 2.0.5 =
* The plugin's folder and translations use its WordPress.org address, mbx-flow, so language packs from WordPress.org apply to it.

= 2.0.2 =
* Everything typed on the MBX Flow page and in the article's MBX Flow box is cleaned before it is used.

= 2.0.1 =
* An article whose share did not go through is shared again the next time it is published or updated, instead of being marked as done.
* Workspace and connection addresses must start with https://, so the connection token never travels unencrypted.
* A workspace on a private network that only knows itself as localhost no longer leaves the site pointed at localhost after connecting: the address you typed is kept.

= 2.0.0 =
* Connecting is one code, taken from MBX Flow under Automation → WordPress. There is no address to copy: the code itself says which workspace to talk to, so a workspace that moves is one the plugin follows on its own.
* The two-step approval is gone. A site already connected keeps working and has nothing to do.
* A workspace that cannot be reached from the internet is still reachable: "I have an address" takes the address alongside the code.

= 1.1.0 =
* The plugin has its own MBX Flow item in the admin menu, and a notice on the dashboard until the site is connected.
* The connection box says which address to enter, and the rest of the page appears once connected.

= 1.0.0 =
* First release: one-click pairing, sharing of new articles with per-article accounts and timing, entries published from MBX Flow with status, category and author settings. English, Spanish, Italian, French and German.
