PHPackages                             iqual/iq\_content\_publishing - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. iqual/iq\_content\_publishing

ActiveDrupal-module

iqual/iq\_content\_publishing
=============================

Platform-agnostic framework for publishing Drupal content to external platforms (social networks, newsletters, etc.) using AI-powered content transformation.

067↓100%PHP

Since Mar 13Pushed 1mo agoCompare

[ Source](https://github.com/iqual-ch/iq_content_publishing)[ Packagist](https://packagist.org/packages/iqual/iq_content_publishing)[ RSS](/packages/iqual-iq-content-publishing/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Content Publishing
==================

[](#content-publishing)

A platform-agnostic framework for publishing Drupal content to external platforms (social networks, newsletters, etc.) using AI-powered content transformation.

Overview
--------

[](#overview)

Content Publishing lets editors send published nodes to any number of external platforms with a single workflow. An AI model transforms the node body into platform-specific structured output (post text, headline, images, links, etc.) that the editor can review and edit before the module dispatches it through the platform's API.

The module ships a **plugin system** so that each target platform (e.g. X / Twitter, LinkedIn, Mailchimp) can be provided by its own sub-module. A bundled example sub-module (`iq_content_publishing_example`) demonstrates how to build a platform plugin.

### Key features

[](#key-features)

- **AI content transformation** – uses the Drupal AI module to convert node content into structured, platform-ready output.
- **Plugin-based platform architecture** – add new platforms by creating a small plugin class with a PHP attribute; no core changes needed.
- **Two-step editorial workflow** – select target platforms, then review and edit AI-generated content before publishing.
- **Per-platform configuration** – credentials, content-type restrictions, and custom AI prompt instructions per platform.
- **Queue support** – optionally dispatch publishing jobs through Drupal's queue system for asynchronous processing.
- **Publishing log** – every publish operation is recorded as a content entity with status, API response, and AI output for auditing and debugging.

Requirements
------------

[](#requirements)

DependencyVersionDrupal core^11Node module(core)Content Moderation(core)[AI module](https://www.drupal.org/project/ai)^1An AI provider (e.g. OpenAI, Anthropic) must be configured in the AI module before content transformation will work.

Installation
------------

[](#installation)

Install as you would normally install a contributed Drupal module. See [Installing Drupal Modules](https://www.drupal.org/docs/extending-drupal/installing-modules)for further information.

```
composer require drupal/iq_content_publishing
drush en iq_content_publishing
```

Configuration
-------------

[](#configuration)

1. Navigate to **Administration » Configuration » Web services » Content Publishing Platforms** (`/admin/config/services/content-publishing`).
2. Click **Add Publishing Platform** to create a new platform configuration.
    - Select the platform plugin.
    - Enter API credentials.
    - Choose which content types the platform should be available for.
    - Optionally customize the AI prompt instructions.
3. Visit the **Settings** tab (`/admin/config/services/content-publishing/settings`) to enable or disable the module globally.

### Permissions

[](#permissions)

PermissionDescription*Administer content publishing*Manage platform configurations and global settings*Publish to external platforms*Trigger the publish workflow from node forms*View publishing log*View the publishing historyUsage
-----

[](#usage)

1. Edit (or view) a published node.
2. Click **Publish externally** in the node form actions area.
3. Select one or more target platforms and click **Next**.
4. Review the AI-generated content for each platform, make any edits, and click **Publish**.
5. Publishing results are shown on-screen and recorded in the publishing log.

The per-node publishing history is available under the **Publishing Log** tab on each node.

Creating a platform plugin
--------------------------

[](#creating-a-platform-plugin)

To add support for a new external platform, create a module with a plugin class:

```
namespace Drupal\my_platform\Plugin\ContentPublishingPlatform;

use Drupal\Core\StringTranslation\TranslatableMarkup;
use Drupal\iq_content_publishing\Attribute\ContentPublishingPlatform;
use Drupal\iq_content_publishing\Plugin\ContentPublishingPlatformBase;
use Drupal\iq_content_publishing\Plugin\PublishingResult;
use Drupal\node\NodeInterface;

#[ContentPublishingPlatform(
  id: 'my_platform',
  label: new TranslatableMarkup('My Platform'),
  description: new TranslatableMarkup('Publish content to My Platform.'),
)]
class MyPlatform extends ContentPublishingPlatformBase {

  public function getOutputSchema(): array {
    return [
      'text' => [
        'type' => 'textarea',
        'label' => 'Post text',
        'required' => TRUE,
        'max_length' => 280,
        'ai_generated' => TRUE,
      ],
    ];
  }

  public function getDefaultAiInstructions(): string {
    return 'Write a short social media post for My Platform.';
  }

  public function buildCredentialsForm(array $form, array $credentials): array {
    $form['api_key'] = [
      '#type' => 'textfield',
      '#title' => $this->t('API Key'),
      '#default_value' => $credentials['api_key'] ?? '',
      '#required' => TRUE,
    ];
    return $form;
  }

  public function publish(NodeInterface $node, array $fields, array $credentials, array $settings): PublishingResult {
    // Call the platform's API and return a PublishingResult.
  }

}
```

See the bundled `iq_content_publishing_example` sub-module for a fully working reference implementation.

Maintainers
-----------

[](#maintainers)

- [iqual](https://www.drupal.org/iqual)

###  Health Score

22

—

LowBetter than 22% of packages

Maintenance58

Moderate activity, may be stable

Popularity12

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity11

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/43082de1b2e2b2b2d48b7ff7dbc7c60ff1d0a015123d4062ac0b49ea0b3b725f?d=identicon)[iqual](/maintainers/iqual)

---

Top Contributors

[![youpixxl](https://avatars.githubusercontent.com/u/3398689?v=4)](https://github.com/youpixxl "youpixxl (39 commits)")

### Embed Badge

![Health badge](/badges/iqual-iq-content-publishing/health.svg)

```
[![Health](https://phpackages.com/badges/iqual-iq-content-publishing/health.svg)](https://phpackages.com/packages/iqual-iq-content-publishing)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)