Documentation

Installation

1. Download pubschedule-bridge.zip from the Download page.

2. In WordPress admin: Plugins → Add New → Upload Plugin.

3. Select the ZIP and click Install Now, then Activate.

4. A new PubSchedule menu appears in your WordPress sidebar.

Initial Configuration

Navigate to PubSchedule → Settings and enter:

Click Save & Test Connection to verify the link.

Adding a Provider Key

Go to PubSchedule → LLM Providers. Four major providers are supported:

Paste your API key and click Save Key. The system makes a minimal live test call to confirm the key works before saving.

Custom Providers

Use the Custom Provider section for any OpenAI-compatible endpoint — Azure OpenAI, a local Ollama instance, Together AI, or vLLM. You provide:

Using the Platform AI Key

On supported plans, PubSchedule provides a managed AI key so you don't need your own. When generating an article, select Platform AI in the model selector. Monthly usage is tracked on your dashboard and limited by your plan.

Fallback Chain

If your primary provider fails (rate limit, outage), the system tries others in order: Anthropic → OpenAI → OpenRouter → DeepSeek. Adding multiple keys gives you resilience against outages.

Languages

Tick the languages you want articles generated in. Each ticked language generates one article per scheduled run.

|------|----------|

Language selection is limited by your plan (1 language on Starter, 2 on Pro, 3 on Agency).

Article Source Mode

After selecting your language(s), you choose the article source mode:

You can switch between modes per-generation and per-schedule — your saved settings are not changed.

Per-Generation Keyword Selection

A keyword chip panel appears after choosing your source mode. Each keyword saved for the selected language is shown as a toggle chip:

When editing a saved schedule, the previously saved keyword selection is restored automatically.

Schedules

Create a schedule on PubSchedule → Generation → New Schedule. Each schedule runs automatically at its configured time and generates one article per selected language.

Schedule options:

Prompt Fragments

Optional add-ons that extend the generated article:

|----------|--------|

Require Review

When enabled (recommended), all generated articles go to the Article Queue for manual approval before publishing. When disabled, articles are published immediately.

What Are Independent Topics?

Independent Topics are saved briefs that let you generate articles without relying on any news feed. Each topic stores:

Creating a Topic

Go to PubSchedule → News Sources and scroll to the Independent Article Topics section. Click Add Topic, fill in the three fields, and save. Topics are stored in your WordPress site.

Plan Limits

|------|--------|

Using a Topic

When generating an article (Instant or Scheduled), select Custom Topic as the source mode. A dropdown shows your saved topics — select one to pre-fill the description. You can also type a one-off description without saving a topic first.

News Sources

News sources are RSS/Atom feeds from websites you trust. The aggregator fetches headlines on a configurable interval. It never fetches full article content — only titles and URLs are used as context signals.

To add a source manually:

1. Click Add Source and fill in the name, website URL, RSS feed URL, and language.

2. Set a fetch interval (e.g. every 60 minutes).

3. Optionally add topic tags to categorise the signals.

AI Source Discovery:

Type a topic and click Discover with AI. The AI suggests reputable news websites with their RSS URLs. Click + Add next to any you want to use.

Source counts are plan-gated: 8 (Starter), 20 (Pro), 40 (Agency).

SEO Keywords

Keywords are saved per language and injected into article prompts so the AI includes them naturally. Add them manually or use AI discovery.

AI Keyword Discovery:

Type a topic, pick a language, and click Discover. Suggested keywords appear as chips. Add them individually or click Add All.

Keyword counts are plan-gated: 10 (Starter), 25 (Pro), 50 (Agency) per language.

Filtering Sources Per Generation

In the News Sources source mode, a checklist of sources for the selected language appears. Uncheck any source to exclude it from this specific generation. On the next generation, all sources are included again by default.

Reviewing Articles

Every generated article appears in PubSchedule → Article Queue with status Pending Review.

Each card shows:

Approving

Click Approve & Publish. The plugin:

1. Fetches the full article from the content service.

2. Creates a WordPress post with wp_insert_post().

3. Routes the post to the page or category you configured in Settings for that language.

4. Marks the article as published and stores the WordPress post ID.

An Edit post ↗ link appears for manual tweaks.

Rejecting

Click Reject, enter a reason, and confirm. The article is removed from the queue and marked rejected. Rejection reasons are stored for your records.

API Connection

Article Posting per Language

For each output language, configure where the WordPress post should be created:

Error Notifications

Enter email addresses (comma-separated) to receive alerts when any automated step fails: news scraping, LLM call, publishing, keyword check.

Click Send Test Email to confirm delivery works.

Log Retention

Set how many days to keep internal error log entries (1–365 days). Older entries are pruned nightly at 03:00.

Feature Limits by Plan

|---------|-------|---------|-----|--------|

Platform AI vs BYOK

You can use both in the same account. Each schedule and each instant generation lets you choose which key source to use.