> ## Documentation Index
> Fetch the complete documentation index at: https://tryroki.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# WordPress Integration

> Automatically publish TryRoki articles to your WordPress site using the Tryroki plugin.

<Card title="Download the TryRoki WordPress Plugin" icon="download" href="/docs/tryroki.zip">
  Version 1.0.0 — requires WordPress 6.4+ and PHP 8.0+. Download `tryroki.zip`.
</Card>

## Overview

The TryRoki WordPress plugin creates a secure REST API on your WordPress site that TryRoki uses to push articles automatically. When TryRoki publishes an article, it sends the title, HTML content, featured image, meta description, and SEO keyword directly to your WordPress site — no credentials required, just a shared secret key.

The plugin also downloads and localises any featured image into your WordPress media library and sets it as the post's featured image. Existing posts can be updated in place when TryRoki regenerates an article.

## Step 1 — Install the plugin

Download the **tryroki.zip** file using the button above, then install it on your WordPress site:

<Steps>
  <Step title="Open the plugin installer">
    In your WordPress admin, go to **Plugins → Add New Plugin**.
  </Step>

  <Step title="Upload the zip">
    Click **Upload Plugin** and select the downloaded `tryroki.zip` file.
  </Step>

  <Step title="Install and activate">
    Click **Install Now**, then **Activate Plugin**.
  </Step>
</Steps>

After activation the plugin registers the REST API endpoints TryRoki needs and creates a settings page under **Settings → Tryroki** in your WordPress admin.

## Step 2 — Connect to TryRoki

Open the TryRoki dashboard and go to **Integrations → WordPress**. Make sure **Tryroki plugin (recommended)** is selected as the connection method, then:

<Steps>
  <Step title="Enter your site URL">
    Enter your **WordPress site URL** (e.g. `https://yourdomain.com`).
  </Step>

  <Step title="Save WordPress settings">
    Click **Save WordPress Settings**. TryRoki generates a unique 48-character secret key and displays it.
  </Step>

  <Step title="Copy the secret key">
    Copy the **Plugin Secret Key** shown in the TryRoki dashboard.
  </Step>

  <Step title="Paste the key into WordPress">
    In your WordPress admin, go to **Settings → Tryroki** and paste the key into the **API Key** field. Save.
  </Step>

  <Step title="Test the connection">
    Back in the TryRoki dashboard, click **Test connection** to verify the plugin can be reached.
  </Step>
</Steps>

## How articles flow to WordPress

When TryRoki publishes an article, a background job sends it to your WordPress site via the plugin REST API at `/wp-json/tryroki/v1/submit`. The request is authenticated using your secret key in the `X-Secret-Key` header.

```
X-Secret-Key: your-48-character-secret-key
```

### What gets sent

Each submission includes the article title, full HTML content, meta description, URL slug, and primary SEO keyword. If TryRoki generated a featured image, the plugin downloads it from its source URL and attaches it to the post in your WordPress media library.

### Post status

You can control whether articles land as **Published**, **Draft**, **Pending**, or **Private** via the **Default Post Status** setting in the TryRoki dashboard. The default is **Published**.

### Updates

If TryRoki regenerates an existing article, it calls `/wp-json/tryroki/v1/edit` to update the post in place rather than creating a duplicate. The plugin tracks which WordPress post ID maps to each TryRoki article so updates land on the correct post.

## Authentication & security

All requests from TryRoki to your WordPress site are authenticated using the shared secret key. The plugin compares incoming keys using a constant-time comparison to prevent timing attacks. No WordPress credentials (username or password) are ever transmitted.

<Warning>
  Ensure your WordPress site is accessible over HTTPS so the secret key cannot be intercepted in transit. If you suspect the key has been compromised, delete the integration in the TryRoki dashboard, re-save to generate a new key, and update the plugin settings.
</Warning>

## Troubleshooting

| Symptom                  | Check                                                                                                                                                    |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Test connection fails    | Verify the site URL is correct and the TryRoki plugin is activated on WordPress.                                                                         |
| Invalid secret key error | Confirm the key copied from the TryRoki dashboard matches exactly what is pasted into Settings → Tryroki on WordPress.                                   |
| Articles not appearing   | Check that WordPress sync is enabled in the TryRoki dashboard and that the default post status is not set to Draft if you expect to see published posts. |
| Featured image missing   | The plugin downloads images from external URLs — ensure your WordPress host can make outbound HTTP requests.                                             |