Integration Guide

📡 RSS Feed Integration

Subscribe to content updates in any RSS reader. Every site has a unique RSS feed URL.

Popular RSS Readers

• ✓
  Feedly - Add the URL to your Feedly account
• ✓
  Google Reader - Subscribe directly from your account
• ✓
  Apple News - Add as a news feed source
• ✓
  Pocket - Subscribe to get articles automatically saved

📝 WordPress Integration

Display ACORNCMS content on your WordPress site.

Setup Instructions

1. 1
   Get your site's RSS feed URL from the admin panel (edit site page)
2. 2
   Go to WordPress Admin Dashboard
3. 3
   Navigate to Settings → Reading
4. 4
   Paste the feed URL into the RSS feed input

Recommended Plugins

⚙️ JavaScript Embed

Embed a live feed widget on any website (HTML, React, Vue, etc.)

Step 1: Add Container HTML

<div id="rss-feed"></div>

Step 2: Add JavaScript Before </body>

<script>
async function loadRssFeed() {
    const feedUrl = '/feeds/YOUR-SITE-SLUG.xml';
    try {
        const response = await fetch(feedUrl);
        const xml = await response.text();
        const parser = new DOMParser();
        const xmlDoc = parser.parseFromString(xml, 'text/xml');
        const items = xmlDoc.querySelectorAll('item');

        const html = Array.from(items).slice(0, 5).map(item => {
            const title = item.querySelector('title')?.textContent || '';
            const link = item.querySelector('link')?.textContent || '';
            const desc = item.querySelector('description')?.textContent || '';
            const date = item.querySelector('pubDate')?.textContent || '';

            return `
                <article style="margin-bottom:20px;padding-bottom:20px;border-bottom:1px solid #eee;">
                    <h3><a href="${link}">${title}</a></h3>
                    <small>${new Date(date).toLocaleDateString()}</small>
                    <p>${desc}</p>
                </article>
            `;
        }).join('');

        document.getElementById('rss-feed').innerHTML = html;
    } catch(e) {
        console.error('Error loading feed:', e);
    }
}
loadRssFeed();
</script>

🔗 Automation (Zapier / IFTTT)

Automatically share new posts to social media, email, or other services.

Setup Instructions

1. 1
   Go to Zapier.com or IFTTT.com
2. 2
   Create a new automation/applet
3. 3
   Select RSS Feed as the trigger
4. 4
   Paste your site's feed URL (from admin panel)
5. 5
   Choose an action to connect to (see below)

Popular Actions

{''} JSON API (Developers)

Use the JSON API for custom integrations and advanced use cases.

Endpoints

GET /api/v1/sites/{apiKey}/posts

GET /api/v1/sites/{apiKey}/posts/{slug}

// Get your site's API key from the admin panel
const apiKey = 'your-api-key-here';

// Fetch all posts
fetch(`/api/v1/sites/${apiKey}/posts`)
    .then(res => res.json())
    .then(data => {
        console.log(data.data);  // Array of posts
        console.log(data.pagination);  // Pagination info
        console.log(data.site);  // Site info
    })
    .catch(error => console.error('Error:', error));

// Fetch single post
fetch(`/api/v1/sites/${apiKey}/posts/my-post-slug`)
    .then(res => res.json())
    .then(data => console.log(data.data))
    .catch(error => console.error('Error:', error));

{
  "data": [
    {
      "id": 1,
      "title": "Welcome to ACORNCMS",
      "slug": "welcome-to-acorncms",
      "excerpt": "Introduction to the system...",
      "content": "<p>Full HTML content...</p>",
      "published_at": "2025-11-05T10:00:00Z",
      "tags": [
        { "id": 1, "name": "Tutorial", "slug": "tutorial" }
      ]
    }
  ],
  "pagination": {
    "current_page": 1,
    "last_page": 5,
    "per_page": 10,
    "total": 45
  },
  "site": {
    "id": 1,
    "name": "My Blog",
    "domain": "myblog.com"
  }
}