Discover RSS 2.0, RSS 1.0\/RDF and Atom feeds and automatically import articles and media.<\/p>\n
Administrator accounts cannot run imports. Select an enabled non-administrator account\nwith only the required import permissions. This is checked when saving settings and\nbefore polling, including for existing feeds whose account is later promoted to admin.<\/p>\n
Enable Import feeds<\/strong> in Modules and open Content > Import feeds<\/strong>. The module\nrequires Managing feeds requires Settings are stored in the feed table. There are no Imports create published resources. Dependent media are created through Discovery can use the current user's registered OAuth2 consumer credentials.\nSaved feeds use their selected import user's credentials for previews and polling.\nTokens are resolved per destination host and port, only over HTTPS, and are never\nstored in feed settings. Missing credentials leave a request anonymous. Native\nimports save their fetch preference for core reimports and medium downloads.<\/p>\n Development sites allow local destinations and self-signed TLS certificates.\nTransport, redirects and certificate checks use the shared The minute tick starts a bounded background job for due feeds. Database leases prevent\nconcurrent claims. The overview shows article counts, cumulative import\/update\/skip\/error\nstatistics and poll times. Each feed has settings, pause\/resume, test\/preview, poll-now,\nreimport and paginated history for articles and dependent media.<\/p>\n Stable source URIs and checksums allow repeated polls without duplicates. Reimport\nprocesses only entries currently present in the feed, preserving resource IDs. Deleted\nresources remain deleted. Media already imported from the same URL is reused. Feeds\nwith more than 100 entries are rejected, rather than silently importing a partial feed.\nWebSub hub links are recognized in feed data; feed fetching uses polling.<\/p>\n Atom entries from With For ordinary feed entries, the Before writing an entry or its media, the importer dispatches the core\n Unchanged and deleted entries are skipped before notifying. Native feed entries\nnotify once; their delegation to mod_admin<\/code> and mod_cron<\/code>. Enter a website or feed URL, select one of the\ndiscovered feeds, and review three example entries beside the import settings.\nDiscovery uses HTML alternate links and HTTP Link headers.<\/p>\nuse<\/code> permission for mod_import_feed<\/code>. New feeds default to the current editor. Administrators and users with use<\/code> permission\nfor mod_admin_identity<\/code> can select another enabled account with Select user<\/strong>.\nSaving records that account and its user groups for background imports; ordinary\nsettings edits preserve the selected account and saved groups. The worker checks that the\neditor is still enabled and uses the editor's current, bounded permissions. Resource,\nmedia and edge operations enforce their normal ACLs; imported HTML is sanitized.<\/p>\nPer-feed settings<\/h2>\n
m_config<\/code> options.<\/p>\nSetting<\/th> Behavior<\/th><\/tr><\/thead> Import user<\/td> Defaults to the creator. Only administrators or users with full account access can select or change it.<\/td><\/tr> Default category<\/td> An existing non-meta category; initially Article.<\/td><\/tr> Content group<\/td> Available when mod_content_groups<\/code> is enabled. Empty uses the site default.<\/td><\/tr>Guess category<\/td> Match tags against existing category names or translated titles, case-insensitively; otherwise use the default category.<\/td><\/tr> Default connections<\/td> Use Add connection to select a predicate and page. Remove entries from the list as needed, then save. Existing article connections are preserved.<\/td><\/tr> Media<\/td> Dependent resources with depiction edges, the most important medium attached directly, or no media import.<\/td><\/tr> Fetch using<\/td> Anonymous by default, or registered OAuth2 credentials for the import user and destination host.<\/td><\/tr> Polling interval<\/td> 5 to 10080 minutes; initially 60 minutes.<\/td><\/tr> Authority<\/td> Non-authoritative by default; authoritative copies also retain source identities.<\/td><\/tr> WordPress enrichment<\/td> Enabled initially in the admin form; use the anonymous public REST API for content, author, dates and featured media. Failures fall back to feed data.<\/td><\/tr> Pause<\/td> Suspend automatic imports. New feeds are active unless saved paused.<\/td><\/tr><\/tbody><\/table>\n m_media<\/code>,\nwhich detects the MIME type and selects the appropriate media category.\nFor each inline image, the importer selects one\nvariant, preferring the largest declared srcset<\/code> width or density, with src<\/code> as\nfallback. Imported variants share one local medium and inline references are rewritten\nto its URL. WordPress featured-image variants reuse the original image. In attached\nmode, other inline images retain their source URLs.<\/p>\nFetch authentication and development<\/h2>\n
z_fetch<\/code> routines;\nbrowser input cannot change the server's environment. OAuth2 credentials are never\nsent over HTTP. Anonymous fetching remains anonymous across redirects.<\/p>\nPolling and identity<\/h2>\n
Zotonic resource feeds<\/h2>\n
mod_export<\/code> advertise a JSON resource link with relation\nhttps:\/\/zotonic.com\/rel\/resource<\/code>. These use m_rsc_import<\/code>, preserving native\nproperties, categories, media embeds and connections. Connection import depth\ndefaults to 1 and accepts 0–10. Content-group\/copyright defaults and cleanup\npatterns apply; category guessing and media-layout choices do not reshape native\nresources. Choosing no media disables native medium downloads.<\/p>\nmod_websub<\/code> enabled, optional subscriptions cover imported articles and,\nwhen selected, their connections within the import depth. Both options default\nto false and require non-authoritative imports and a supporting source. Existing\nsubscriptions are managed separately through WebSub administration. Native\nresources use the core Fetch new version flow and saved import options, without\nrequiring the entry to remain in the feed. These refreshes use the core import\nnotification with native resource source metadata.<\/p>\nFetch new version<\/h2>\n
rsc_import_fetch<\/code> observer refreshes known imported articles from their current\nfeed, using the saved settings and import account. The caller needs feed-management\nand article-edit permission. Paused feeds can be refreshed manually without resuming\npolling. This bypasses unchanged checksums and still runs the import notification.\nAn article no longer present in the feed returns feed_entry_not_found<\/code>; unknown\nURIs fall through to the standard resource importer.<\/p>\nImport notification<\/h2>\n
#import_resource{item, related, source, options, raw}<\/code> notification. The source\nis #{importer => mod_import_feed, feed => Settings}<\/code>. Include\nzotonic_core\/include\/zotonic.hrl<\/code>, declare zotonic_observer<\/code>, and implement\nobserve_import_resource\/2<\/code> or its optional PID-aware variant. See the core\nobserver documentation for the payload, permissions and result contract.<\/p>\nm_rsc_import<\/code> preserves this scope, while\nrecursively imported resources may generate separate notifications.<\/p>","slug":"mod_import_feed","doc_module_config":[],"is_protected":false,"visible_for":0,"tz":"UTC","language":["en"],"doc_source_hash":"63949bdb402fb4881e35f2d02367d8ed02d99b009a08a56e8aaa37f974cbb268","is_featured":false,"content_group_id":{"id":2551,"is_a":["meta","content_group"],"name":"content_group_imported_docs","title":"Imported documentation","uri":"https:\/\/zotonic.com\/id\/content_group_imported_docs"},"category_id":{"id":320,"is_a":["meta","category"],"name":"module","title":"Modules","uri":"https:\/\/test.zotonic.com\/id\/320"},"doc_source_path":"apps\/zotonic_mod_import_feed\/src\/mod_import_feed.erl","publication_start":"2026-10-13T15:15:42Z","github_url":"https:\/\/github.com\/zotonic\/zotonic\/blob\/master\/apps\/zotonic_mod_import_feed\/src\/mod_import_feed.erl","pivot_location_lng":null,"doc_source_kind":"module","name":"doc_module_mod_import_feed","is_unfindable":false,"is_published":true,"pivot_geocode":null,"created":"2026-10-13T15:15:42Z","uri":null,"doc_status":"current","is_dependent":false,"erlang_app":"zotonic_mod_import_feed","publication_end":"9999-06-01T00:00:00Z","modifier_id":{"id":1,"is_a":["person"],"name":"administrator","title":"Site Administrator","uri":"https:\/\/zotonic.com\/id\/1"},"privacy":0,"doc_source_commit":"92d27433689eef55504265c6dd5486c65dd73483\n","creator_id":{"id":1,"is_a":["person"],"name":"administrator","title":"Site Administrator","uri":"https:\/\/zotonic.com\/id\/1"},"modified":"2026-10-13T15:40:16Z","title_slug":"mod_import_feed"},"uri":"https:\/\/zotonic.com\/id\/3085","uri_template":"https:\/\/zotonic.com\/id\/:id","websub":{"hub":"https:\/\/zotonic.com\/.zotonic\/websub","topic":"https:\/\/zotonic.com\/.zotonic\/websub\/topic\/3085"}},"status":"ok"}