How-to Guides & FAQ

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

---

Route content from a source into a community

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

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	Trusted 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 → Community Rinklingen
Target Community	Select the desired community 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 community.

Step 3 – Verify the result

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

---

Set up a new community from scratch

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

Overview

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

Step 1 – Create the community

Navigate to Admin → Communities and click "New Community".

• Choose a unique Name and a suitable Join Mode (Open, Request, or Invite).
• Upload an image representing the location.

Step 2 – Configure community settings

Open the community settings via Admin → Community 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 community 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 community.

---

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, community settings, and routing rule are identical.

Structuring routing rules

Priority	Use case
10–50	Specific sources (one source → one community)
51–100	Area-based rules (Area X → Community 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
Trusted	Official municipalities, authorities, established media
Community	Local clubs, citizen blogs
Unverified	New, unknown sources (monitor initially)