Documentation

Everything you need to install, configure, and use HalaSpace Bridge.

Quick Start

Installation

1. Download halaspace-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 HalaSpace menu appears in your WordPress sidebar.

Initial Configuration

Navigate to HalaSpace → Settings and enter:

  • API Gateway URL — leave as default for cloud deployment.
  • Service Token — copy this from your HalaSpace account dashboard.

    • Click Save & Test Connection to verify the link.

    LLM Providers

    Adding a Provider Key

    Go to HalaSpace → LLM Providers. Four providers are supported:

  • Anthropic — Claude models (Haiku, Sonnet, Opus)
  • OpenAI — GPT-4o, GPT-4o-mini
  • OpenRouter — access to 200+ models with one key
  • DeepSeek — affordable high-quality models

    • Paste your API key and click Save Key. The system fires a real minimal 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:

  • Base URL (e.g. `https://api.together.xyz/v1`)
  • API key
  • Model name (e.g. `meta-llama/Llama-3-70b-chat-hf`)

    • Fallback Chain

    If your primary provider fails (rate limit, outage), the system tries others in order: Anthropic → OpenAI → OpenRouter → DeepSeek. You only need one key for things to work, but adding multiple keys gives you resilience.

    Content & Schedule

    Languages

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

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

    Prompt Template

    The default template produces a 400–600 word news article. Three placeholders are always replaced at generation time:

  • `{language}` — the output language name
  • `{topic_signal}` — headlines extracted from your news sources
  • `{keywords}` — your configured SEO keywords for that language

    • You can edit the template freely. The Reset button restores the default.

    Schedule

  • News scrape interval — how often the system checks RSS feeds (every hour, twice daily, or daily).
  • Article generation time — the clock time each day when articles are generated (e.g. `06:00`).

    • Require Review

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

    News Sources & Keywords

    News Sources

    News sources are RSS/Atom feeds from websites you trust. The aggregator fetches headlines on a configurable interval (minimum 15 minutes). It never fetches full article content — only titles and URLs.

    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. Add topic tags like real estate, tourism to categorise the signals.

    AI Source Discovery:

    Type a topic (e.g. "Turkish real estate investment") and click Discover with AI. The AI suggests real, reputable news websites with their RSS URLs. Click + Add next to any you want to use.

    SEO Keywords

    Keywords are injected into every article prompt so the AI includes them naturally. Add keywords per language.

    AI Keyword Discovery:

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

    Example English keywords: buy apartment Istanbul 2026, Turkish real estate investment, Istanbul property prices.

    Article Queue

    Reviewing Articles

    Every generated article appears in HalaSpace → Article Queue with status review.

    Each card shows:

  • Title and excerpt
  • Language badge
  • Model used and generation time
  • Expand button to read the full article

    • Approving

    Click Approve & Publish. The plugin:

    1. Fetches the full article from the content service.

    2. Creates a real WordPress post with wp_insert_post().

    3. Routes the post to the page/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 so you can make manual tweaks.

    Rejecting

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

    Settings

    API Connection

  • API Gateway URL — the base URL of the backend gateway. Default: `http://api-gateway:8000` (works in the provided Docker setup).
  • Service Token — your unique authentication token from your HalaSpace account dashboard.

    • Article Posting per Language

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

  • Parent Page — which WordPress page it appears under (optional).
  • Category — which category is assigned.
  • Post Status — `published` (live immediately), `draft` (hidden), or `pending` (awaiting WP editor review).

    • 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.