# Ordio Product Updates Feed – User Guide

**For:** Product Team  
**Purpose:** How to use the feed and in-app banner features for Ordio

---

## What’s new

Two feeds are available for product updates:

1. **RSS feed** – for RSS readers and general syndication
2. **JSON feed** – for Ordio to show “New feature” banners

You can control which updates appear in the in-app banner via a checkbox in the admin.

---

## Admin: Enabling in-app banners

### For individual features or improvements

1. Open **Product Updates Admin** → [ordio.com/produkt-updates-admin](https://www.ordio.com/produkt-updates-admin)
2. Add or edit a **Feature** or **Improvement**
3. In the form, find **“Anzeige”** (Display)
4. Check **“In-App-Banner anzeigen (Web-App)”**
5. Save

Only items with this enabled will be shown in the banner in the Ordio app.

### For multiple items (bulk update)

1. In the admin, go to **Features** or **Improvements**
2. Select the items you want via the checkboxes
3. Click **“Update In-App Banner”**
4. Check or uncheck **“In-App-Banner anzeigen (Web-App)”**
5. Click **Update**

The setting applies to all selected items.

---

## Feed URLs

### For the Ordio team (in-app banners)

| URL                                                                                     | Purpose                                 |
| --------------------------------------------------------------------------------------- | --------------------------------------- |
| `https://www.ordio.com/produkt-updates/feed.json`                                       | All updates (JSON format)               |
| `https://www.ordio.com/produkt-updates/feed.json?in_app_banner_only=1`                  | Only items marked for in-app banner     |
| `https://www.ordio.com/produkt-updates/feed.json?type=big_feature`                      | Only big features                       |
| `https://www.ordio.com/produkt-updates/feed.json?type=small_improvement`                | Only small improvements                 |
| `https://www.ordio.com/produkt-updates/feed.json?platform=mobile`                       | Only items for mobile                   |
| `https://www.ordio.com/produkt-updates/feed.json?in_app_banner_only=1&type=big_feature` | Banner items that are big features only |
| `https://www.ordio.com/produkt-updates/feed.json?month=2025-02`                         | Only February 2025 updates              |
| `https://www.ordio.com/produkt-updates/feed.json?year=2025`                             | Only 2025 updates                       |
| `https://www.ordio.com/produkt-updates/feed.json?from=2025-02-01&to=2025-02-28`         | Updates within a date range             |

### For feed readers (optional)

| URL                                              | Purpose                                         |
| ------------------------------------------------ | ----------------------------------------------- |
| `https://www.ordio.com/produkt-updates/feed.xml` | RSS feed – subscribe in Feedly, Inoreader, etc. |

The RSS feed is ready to use. No extra setup needed – add the URL to any feed reader to get product updates. The RSS feed supports the same query params as the JSON feed (e.g. `?month=2025-02`).

### Limits

- **JSON feed:** Up to 50 items from the last 12 months
- **RSS feed:** Last 12 months of updates (no strict item limit)

---

## JSON Feed item structure

Each item in the feed includes:

| Field            | Type           | Description                                                |
| ---------------- | -------------- | ---------------------------------------------------------- |
| `id`             | string         | Unique item ID                                             |
| `url`            | string         | Link to product updates page (with anchor)                 |
| `title`          | string         | Feature or improvement title                               |
| `content_html`   | string         | Full HTML description                                      |
| `summary`        | string         | Plain-text excerpt (max 200 chars)                         |
| `date_published` | string         | ISO 8601 date                                              |
| `tags`           | array          | Tag(s), e.g. `["Zeiterfassung"]`                           |
| `image`          | string \| null | Image URL (if set)                                         |
| `_ordio`         | object         | Ordio extension: `type`, `show_in_app_banner`, `platforms` |

**`_ordio` fields:**

- `type`: `"big_feature"` or `"small_improvement"` – use to separate big features from small improvements
- `show_in_app_banner`: `true` or `false` – whether to show in-app banner
- `platforms`: `["desktop"]`, `["mobile"]`, or `["desktop","mobile"]` – where the item is available

---

## How the Ordio team can use it

1. Fetch the feed from the URL above (e.g. `feed.json?in_app_banner_only=1`)
2. Use the items to show “New feature” banners
3. Use `_ordio.type` to separate big features from small improvements (e.g. different UI treatment)
4. Use `_ordio.platforms` to show only relevant items on desktop vs mobile
5. Each item includes: title, description, link, image (if available), tag(s), date

---

## Summary

- **Admin:** Add/edit updates and enable “In-App-Banner anzeigen” for each item or in bulk
- **JSON feed:** Use for the Ordio app. Query params: `in_app_banner_only=1`, `type=big_feature|small_improvement`, `platform=desktop|mobile`, `month=YYYY-MM`, `year=YYYY`, `from=YYYY-MM-DD`, `to=YYYY-MM-DD`
- **RSS feed:** Use for feed readers (Feedly, Inoreader, etc.) – no extra setup needed