Color Vivo Social Publishing for Postiz
WordPress plugin: auto-publish and schedule your content on social networks through your own Postiz instance (self-hosted or Postiz Cloud).
Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/dcarrero/color-vivo-social-publishing-for-postiz/archive/refs/heads/main.zipWordPress plugin that auto-publishes and schedules your content on social networks through your own Postiz instance (self-hosted or Postiz Cloud). WordPress talks directly to the Postiz public API: no middleman service.
- Requires WordPress 7.0+ and PHP 8.2+.
- Status: version 1.0.0 (see CHANGELOG.md).
Features
- Direct connection to your Postiz instance (self-hosted or Postiz Cloud), with automatic API path detection and a card in Settings → Connectors.
- Publishing profile per post type: channels, common and per-network templates, network settings, timing (now, delay, next free slot, draft).
- Templates with tags (
{title},{excerpt},{url},{first_category},{reading_time},{hashtags:post_tag},{meta:key}…), filters (|limit:200,|words:30,|default:text,|upper…) and thread parts (---); an "Insert tag" menu in the editor and the settings. Full list in the readme.txt FAQ. - Images: featured, featured plus the images in the post, or picked per post in the editor (up to 10), trimmed to what each network accepts.
- Conditions on categories and tags, UTM parameters per network, Postiz shortener and tags.
- Background sending (Action Scheduler) with retries, duplicate protection and an activity log with summary cards (published, queued, errors, requests in the last hour against the Postiz limit).
- Pending posts are cancelled in Postiz when a post is unpublished.
- Status sync with Postiz (published URL, platform errors), triggered by the Postiz webhook or every 15 minutes. The Webhook tab shows its state, a setup guide, a self-check of the URL and the last calls.
- Block editor panel (channels, timing per post, one tab per network for its own text, preview drawn like each network, status with share again / retry / cancel pending), classic editor metabox, posts list column with a status filter, dashboard widget, and failure alerts (admin notice and optional email).
- "Test this profile" panel in the settings: pick a post and see what the saved profile would send.
- Export and import of publishing profiles (JSON) to copy them between sites.
- REST routes for status, channels, a post's shares and a dry-run preview.
- WP-CLI:
wp social-publishing status|test|channels|preview|share|shares|cancel|sync|log(wp help social-publishingfor details). - Abilities API:
socialrelaycvi/get-status,list-channels,preview-post,share-post,get-post-shares,cancel-post-shares, available to AI agents through the MCP Adapter. - English base, Spanish (es_ES) translation included.
Development
composer install
npm ci
npm run build # editor panel: assets/src → build/ (required, build/ is not in git)
npm run start # same, rebuilding on every change
npm run lint:js # WordPress ESLint rules
npm run lint:css # WordPress stylelint rules
npm run env start # WordPress in Docker (@wordpress/env) at http://localhost:8890, admin/password
npm run env run cli wp social-publishing status # WP-CLI inside that site
composer test # PHPUnit (unit tests, no WordPress needed)
composer lint # PHPCS with WordPress Coding Standards + PHPCompatibility
composer analyse # PHPStan
To try it against a Postiz on your machine or LAN, add define( 'SOCIALRELAYCVI_ALLOW_LOCAL_INSTANCE', true ); (in wp-env: npm run env run cli wp config set SOCIALRELAYCVI_ALLOW_LOCAL_INSTANCE true --raw) and use http://host.docker.internal:<port> as the URL.
Layout
| Path | What it does |
|---|---|
color-vivo-social-publishing-for-postiz.php |
Bootstrap: requirements, autoload, Action Scheduler, hooks |
src/Plugin.php |
Service container and module registry (socialrelaycvi_modules filter) |
src/Postiz/ |
API client, endpoint detection, channel cache, per-network rules |
src/Templates/ |
Template engine ({tags}, \|filters, --- threads) and post context |
src/Sharing/ |
Payload builder, share job and preview, conditions, UTM, shares table |
src/Lifecycle/ |
Installer (tables) and post listener |
src/Connector/ |
Settings → Connectors registration (WordPress 7) |
src/Rest/ |
socialrelaycvi/v1 routes (editor, admin screens) and the Postiz webhook |
src/Sync/ |
Status sync with Postiz |
src/Cli/ |
WP-CLI commands |
src/Abilities/ |
Abilities API registration |
src/Admin/ |
Menu and loaders for the React screens, classic metabox, dashboard widget |
assets/src/editor-panel/ |
Block editor panel in JSX |
assets/src/common/ |
Pieces shared by the screens: network colours and the preview card |
assets/src/settings/, assets/src/log/ |
Settings and log screens in JSX (all built into build/ with @wordpress/scripts; @wordpress/* packages come from WordPress) |
languages/ |
.pot template and translations |
Extending
Add-ons register their own modules:
add_filter( 'socialrelaycvi_modules', function ( array $modules, \SocialRelayCvi\Plugin $plugin ) {
$modules['my_module'] = new My_Module( $plugin ); // implements \SocialRelayCvi\Module
return $modules;
}, 10, 2 );
Other hooks: socialrelaycvi_gateway, socialrelaycvi_status_changed, socialrelaycvi_cancel_on_unpublish, socialrelaycvi_template_context, socialrelaycvi_payload, socialrelaycvi_should_share, socialrelaycvi_shared, socialrelaycvi_post_types, socialrelaycvi_allow_local_instance, socialrelaycvi_log_retention_days.
Releases
bin/build-release.sh # dist/color-vivo-social-publishing-for-postiz.zip, ready to install or upload
git tag -a v1.0.0 -m "1.0.0" && git push --tags # CI builds the zip and publishes the release
The release workflow deploys to wordpress.org SVN when the repository has the SVN_USERNAME and SVN_PASSWORD secrets (after the plugin is approved). Banner, icon, screenshots and the Live Preview blueprint live in .wordpress-org/ (they go to the SVN assets/ folder, not into the plugin zip).
Brand
Color Vivo Social Publishing for Postiz is a product by Color Vivo. It is not affiliated with or endorsed by Postiz.
Translations
All strings are written in English with the color-vivo-social-publishing-for-postiz text domain. languages/ holds the .pot template and the Spanish (es_ES) translation, ready to import into translate.wordpress.org. They stay in the repository only: the release zip leaves languages/ out, as wordpress.org asks, and WordPress loads translations (PHP and JavaScript) from the language packs; the plugin does not call load_plugin_textdomain().
composer i18n # regenerate the .pot, update the .po files and compile the .mo files
In JavaScript, write the text domain literally in every call (__( 'Text', 'color-vivo-social-publishing-for-postiz' )) so the extractor finds it; run npm run build before composer i18n, because strings are extracted from build/. When adding strings: use _x() when a word has more than one meaning (e.g. "Post"), _n() for counts, and a translators: comment for every placeholder.
License
GPL-2.0-or-later. Not affiliated with or endorsed by Postiz.