diora-web/docs/sources.md

# Abos & Quellen (navigation phase 2)

One place to manage every subscription: podcasts, YouTube channels, audiobooks,
news sources and blogs. The everyday views (Strom, Merkliste, Wiedergabeliste — docs/podcasts.md —,
Nachrichten, Blogs, Hörbücher) show content; adding, changing and removing sources happens
here (their own small entry points lead here).

## Where

`DioraNav` section `sources` ("Abos & Quellen", icon ⚙), panel `#tab-sources`,
`group: 'more'`, `footer: true`:
- not in `groups()` (no tab of its own on a phone);
- in `sections()` with `footer: true`: the sidebar puts it at the bottom, above
  "Menü"; the phone's app menu has an entry; diora Reader's bar leaves it out;
- the web page's bar: at the end (wide), as ⚙ (narrow).

## The page (`static/js/sources.js`, diora-web, every platform)

- **Hinzufügen**: one field for an address or search words.
  - a YouTube address → its channel (`/podcasts/search/?q=`), as Podcast or Hörbuch;
  - another address → `/feeds/discover/`: every feed found, with the kind it
    looks like (`suggested_kind`: `podcast` when most entries carry sound or
    video, else `news`/`blog`) and whether it's subscribed already
    (`subscribed` as a feed, `podcast_subscribed`); the kind can be changed:
    Podcast · Hörbuch · Nachrichten · Blog;
  - words → the podcast directory (`/podcasts/search/`).
  Podcast/Hörbuch subscribe with `POST /podcasts/feeds/add/` (then
  `settings {kind: 'audiobook'}`), Nachrichten/Blog with `POST /feeds/sources/add/`.
- **The list**: all sources, filter chips Alle · Podcasts · YouTube · Hörbücher ·
  Nachrichten · Blogs · Probleme (fetching fails), and a search over the names.
- **A source's actions** (tapping it): open its content, its settings (the
  existing editors), change its kind (Podcast ↔ Hörbuch, Nachrichten ↔ Blog),
  unsubscribe.
- **Import & Export**: OPML for podcasts and feeds.

## Hooks it uses (each optional: without it, it goes to the section instead)

| Hook | From | Does |
|------|------|------|
| `__dioraPodcastFeedSettings(feedId)` | native-podcast.js | opens the podcast's settings sheet |
| `__dioraPodcastOpenFeed(feedId)` | native-podcast.js | shows the podcast's episode list (Podcasts section) |
| `__dioraFeedsEdit(sourceId)` | feeds.js | opens the source's editor (Nachrichten/Blogs, manage view) |
| `__dioraFeedsStale()` | feeds.js | its state is old: load again when shown |
| `__dioraAudiobookOpen(feedId)` | audiobooks.js | opens the book |

The host calls it uses: `podcastState`, `podcastFeedSettings`, `podcastRefresh`
(after subscribing), `podcastFeedRemoved` (after unsubscribing).