How-to Guides & FAQ

Practical step-by-step guides for the most common admin tasks.

---

Route content from a source into a place

Goal: Articles from a specific RSS source or geographic area should automatically appear in a specific place.

Step 1 – Add a source

Navigate to Admin → Sources and click "New Source".

Field	Recommendation
Name	Descriptive name, e.g. "Municipal Office Rinklingen"
URL	RSS/Atom feed URL
Area	Locality or region, e.g. rinklingen (lowercase)
Trust Level	Official for official sources
Tags	Optional keyword tags for pre-sorting

Consistent area names

Always use the same spelling for Area (lowercase, no spaces). The exact same value will be used as the condition value in the routing rule.

Step 2 – Create a routing rule

Navigate to Admin → Routing Rules and click "New Rule".

Fill in the form as follows:

Field	Value
Name	e.g. Rinklingen → Place Rinklingen
Target Place	Select the desired place from the list
Order	100 (lower number = higher priority)

Add a condition:

• Field: Area
• Operator: Equals
• Value: rinklingen (exactly as entered in the source)

How the condition works

When an article is processed, the system checks all routing rules in priority order. If the article's area matches rinklingen, it is routed to the selected place.

Step 3 – Verify the result

• Open the target place and check Posts to see if new articles appear.
• New articles are processed on the next feed refresh.

---

Set up a new place from scratch

Goal: Build a new locality or interest group with its own content stream.

Overview

Create place → Set areas → Add sources → Create routing rules

Step 1 – Create the place

Navigate to Admin → Places and click "New Place".

• Choose a unique Name and a suitable Join Mode (Open, Request, or Invite).
• Enter a logo URL (HTTPS) to use as the place avatar. Direct image upload is planned.

Step 2 – Configure place settings

Open the place settings via Admin → Place Settings.

• Under Areas, enter one or more place names (e.g. rinklingen).
• These areas will serve as the basis for routing rules.

Step 3 – Add sources

Add all relevant RSS sources under Admin → Sources and assign them the matching Area (must match the place settings entry exactly).

Step 4 – Create routing rules

Create a routing rule for each source (or area) as described in the guide above.

Plan your rule order

Specific rules (e.g. a single source) should have a lower order number (higher priority) than general area-based rules.

---

Auto-tag articles with Keyword Tags

Goal: Articles are automatically tagged based on keywords; tags can then be used in routing rules or for filtering.

Step 1 – Create a keyword tag

Navigate to Admin → Keyword Tags and click "New Tag".

Field	Description
Tag Name	Unique name, e.g. clubnews
Keywords	Comma-separated keywords, e.g. club, association, general meeting

Case sensitivity

Keyword matching is case-insensitive. Club and club are treated the same.

Step 2 – Create a routing rule for the tag

Create a routing rule with the following condition:

• Field: Tag
• Operator: Contains
• Value: clubnews

Any article containing one of the keywords will automatically be routed to the chosen place.

---

Best Practices

Consistent area naming

• Use lowercase without special characters, e.g. bretten instead of Bretten.
• Avoid spaces; use hyphens instead: bad-schoenborn.
• Ensure the Area value in the source, place settings, and routing rule are identical.

Structuring routing rules

Priority	Use case
10–50	Specific sources (one source → one place)
51–100	Area-based rules (Area X → Place Y)
101–200	General rules (tag contains "news" → General)

Normalizing keyword tags

• Tags are instance-wide; choose generic names rather than source-specific ones.
• Regularly review whether tags are still actively used.

Source trust levels

Level	Recommendation
Official	Official municipalities, authorities, utilities
Partner	Known partner organisations
Community	Community-maintained sources, e.g. local blogs
External	New or unknown external sources