Описание
PlanetFOSS reads close to 200 Linux and open source sources in German and English, sorts every report into topics and counts them. This plugin brings those numbers to your blog.
Topic card below posts. A post tagged «KDE Plasma» gets the PlanetFOSS topic KDE Plasma: a short intro, how many reports from how many sources appeared in the last 30 days, a small daily chart, the biggest version topics and a link to all reports.
Linux news for the sidebar. The topics with the most reports in the last 24 hours and in the last 7 days, each with a seven-day sparkline – plus links to the weekly review and the logbook.
Fits your theme
- Font, text colour and link colour come from your theme. Lines and muted text are mixed from the text colour, so light and dark themes work without settings.
- Sizes in em: the card follows the font size of the place it sits in.
- Every rule uses a single class. Bare theme rules for
h2oruldo not break it, and any rule of yours that names a class wins. - Custom properties for quick changes:
--planetfoss-accent,--planetfoss-line,--planetfoss-muted,--planetfoss-surface,--planetfoss-border,--planetfoss-radius,--planetfoss-pad,--planetfoss-link,--planetfoss-mono. - Block style «Plain» (no box), plus the usual block settings for colour, typography, border and spacing.
- Turn the stylesheet off completely and style the BEM classes (
planetfoss__…) yourself.
Works without setup
- Topics are matched automatically: a tag or category whose slug or name equals a PlanetFOSS topic. If your blog is itself a PlanetFOSS source, PlanetFOSS’s own sorting of your posts is used first.
- Pick a topic by hand in the block settings when the automatic match is not what you want.
- Blocks for the block editor and block themes, a classic widget, shortcodes, and an optional card below every post.
Honest links, no tracking of readers
- The plugin shows only what PlanetFOSS itself produces: topic names, intros, counts. Never headlines of other sites.
- Every link goes to planetfoss.net and says so.
- Once you turn on the connection, your server fetches the data every 30 minutes and stores it. Your readers load nothing from planetfoss.net – no scripts, no fonts, no images, no cookies.
- Everything is rendered on the server. No JavaScript on your pages.
- Links to PlanetFOSS carry campaign tags (
utm_source= your site’s host name,utm_medium=verbund,utm_campaign=topicornews). They name your site, never your reader. PlanetFOSS counts them as daily totals to show how many readers each site sends; it keeps site names for 90 days. Turn the tags off with the filterplanetfoss_link_tags.
Licence of the data
The PlanetFOSS data (topic names, intros, counts) are licensed under CC BY 4.0. The plugin credits PlanetFOSS, links to it and shows the licence in a small note in every box, so you are covered. Details: https://planetfoss.net/wordpress/#terms
Languages
PlanetFOSS exists in German and English. The data follows the language of your site (or the setting). The plugin interface is translatable.
External services
This plugin connects to the PlanetFOSS API at planetfoss.net to get the topic data it displays. Without this service the plugin shows nothing.
- Consent first: nothing is sent after installing or activating the plugin. The connection stays off until an administrator turns it on under Settings PlanetFOSS; turning it off again stops all requests and deletes the stored data.
- What is sent and when: once the connection is on, every 30 minutes (WP-Cron) and when you press «Fetch now», your server requests
https://planetfoss.net/api/verbund/v1/themen.json. The request contains the language (deoren), the host name of your site (site=, so PlanetFOSS can return the topics of your own posts if your blog is one of its sources) and, only if you entered one, your access key. - Limits: without a key PlanetFOSS allows a few requests per hour per server; the plugin needs two. On any error the last good data stays in place.
- When readers click a link: the link carries the host name of your site as
utm_source(see above), nothing else. - What is not sent: nothing about your visitors. Your visitors never connect to planetfoss.net through this plugin; they only follow links if they click them.
- PlanetFOSS terms of use for the data: https://planetfoss.net/wordpress/#terms
- PlanetFOSS privacy policy: https://planetfoss.net/datenschutz/
Скриншоты




Блоки
Этот плагин предоставляет 2 блока.
- PlanetFOSS Linux news The topics with the most reports in the Linux and open source news, last 24 hours and last 7 days, counted by PlanetFOSS. Made for sidebars.
- PlanetFOSS topic The matching PlanetFOSS topic for this post: intro, reports of the last 30 days, link to all reports. Place it below the post content.
Установка
- Install and activate the plugin.
- Go to Settings PlanetFOSS, turn on «Connect to PlanetFOSS», save and check that the first fetch worked.
- Add the block «PlanetFOSS Linux news» to your sidebar (Appearance Editor or Widgets), or use the classic widget of the same name.
- For the topic card: add the block «PlanetFOSS topic» below the post content in your single post template, or turn on «Card below posts» in the settings.
Shortcodes for classic themes and page builders:
[planetfoss_topic]– card for the current post;[planetfoss_topic topic="gnome"]for a fixed topic.[planetfoss_news layout="list" limit="6" title="Linux news"]–layout="columns"for wide areas;style="plain"removes the box on both.
Часто задаваемые вопросы
-
Why does a post show no card?
-
None of its tags or categories matches a PlanetFOSS topic with reports in the last 30 days. Pick a topic in the block settings, or use the filter
planetfoss_post_topics. -
Can I change the HTML?
-
Use the filters
planetfoss_topic_htmlandplanetfoss_news_html. Other filters:planetfoss_link_tags,planetfoss_post_topics,planetfoss_auto_post_types,planetfoss_load_styles,planetfoss_endpoint,planetfoss_site_host. -
Does it slow down my site?
-
No. The data is fetched in the background and kept in one database option that is not autoloaded. Rendering needs no request to another server.
-
Does it work with page caching?
-
Yes. The numbers are at most 30 minutes old plus the lifetime of your page cache. The news list shows when the data was counted.
-
Who runs PlanetFOSS?
-
PlanetFOSS is an independent Linux and open source news aggregator from Germany. See https://planetfoss.net/ueber/.
Отзывы
Нет отзывов об этом плагине.
Участники и разработчики
«PlanetFOSS» — проект с открытым исходным кодом. В развитие плагина внесли свой вклад следующие участники:
УчастникиПеревести «PlanetFOSS» на ваш язык.
Заинтересованы в разработке?
Посмотрите код, проверьте SVN репозиторий, или подпишитесь на журнал разработки по RSS.
Журнал изменений
0.3.1
- New PlanetFOSS mark (planet with ring and star) in the header of the topic card and the news list.
0.3.0
- The plugin no longer contacts planetfoss.net on activation. The connection is off until an administrator turns it on in Settings PlanetFOSS; turning it off deletes the stored data. Sites that already fetched data keep their connection.
- The User-Agent no longer contains the site address.
- Translations come from translate.wordpress.org instead of files inside the plugin.
0.2.2
- German translation complete: settings page help texts, admin notice and block descriptions.
0.2.1
- Plugin header name shortened to «PlanetFOSS» (slug and text domain
planetfoss); no functional changes.
0.2.0
- Links to PlanetFOSS carry campaign tags naming your site (not your readers), so PlanetFOSS can show how many readers each site sends. Filter
planetfoss_link_tagsturns them off. - Narrow sidebars: sparkline and count move below the topic name.
- Licence note CC BY 4.0 in every box.
0.1.0
- First version: topic card and Linux news as blocks, classic widget and shortcodes; automatic topic matching; server-side rendering; theme-friendly stylesheet.
