# Release 2.4.0

**URL:** <https://community.podlove.org/t/release-2-4-0/771>\
**Category:** Podlove Publisher Releases\
**Created:** [December 5, 2016, 10:59am UTC](https://community.podlove.org/t/release-2-4-0/771 "2016-12-05T10:59:58Z")\
**Posts on this page:** 15\
**Page:** 1

<div class="post-metadata">

**Author:** ![ericteubert](https://community.podlove.org/user_avatar/community.podlove.org/ericteubert/32/1568_2.png) [@ericteubert](https://community.podlove.org/u/ericteubert)\
**Post date:** [December 5, 2016, 10:59am UTC](https://community.podlove.org/t/release-2-4-0/771/1 "2016-12-05T10:59:58Z")

</div>

**Background Jobs System**

Crunching numbers for Analytics takes time, especially for popular podcasts with many downloads. The old system was written optimistically and “let’s-hope-we-finish-before-we-run-out-of-time”-ish. That was certainly good enough for podcasts with a few hundred downloads per episode, but more likely a gamble for popular shows.  
To solve this issue in a scaleable way, we built what is known as “background processing” or “queues”. That way we can break big tasks into small chunks and process them step by step. You don’t really need to know about this, since the main effect is that calculating analytics should be a smoother experience (if you have ever had troubles in that regard) but if you are curious, have a look at the new “Tools” section, which lists running and recently finished jobs.

**New Analytics Dashboard**

- “Downloads per Day” is a stacked bar chart now so you can see which episode is responsible for peaks
- Downloads table now shows downloads in time segments starting from the moment of episode release for better comparability
- Show total number of all downloads in Analytics Dashboard
- New information under downloads table: age of the data and when the next refresh is due
- _MUCH_ better performance / page load times
- New option to configure how many episodes per page should be shown

**Podlove Web Player 2 Facelift**

- simplified, modernised look
- responsive layout for mobile devices
- fix: updated mediaelement library to fix volume bar display bug

**Podigee Podcast Player**

The [Podigee Podcast Player](https://www.podigee.com/en/podcast-player) is available as an alternative to the Podlove Web Players. It supports everything you can expect from a modern web player like chaptermarks. It is also embeddable.

**New “Tools” Menu**

- A new maintenance section gathers tools like the “Repair” button in one place
- There is a new section for analytics related maintenance
- Import & Export is now in the “Tools” menu

**Improved Logging Display**

- Logging is now in the “Support” menu
- add filtering for different severities
- hide “info” entries by default
- improve readability of data sections

**Other**

- add Emoji support for episode subtitle, summary and chapter marks (requires WordPress 4.2 or newer)
- Web Player setttings moved from Expert Settings to Podcast Settings
- When activating the plugin, add mp3 asset and feed to help users get over the most confusing part of the setup.
- Post thumbnails can be used as episode covers (see settings in “Episode Assets”). This is the new default.
- add contributors shortcode to default template (Many people activated contributors and then wondered why they were not displayed in the episode. Now the shortcode is part of the default template, but only if the contributors module is active.)
- add unmistakable warning if curl is not available and provide actionable steps for a solution
- change feed setting “Include HTML Content” default to “on”
- remove log entries for beginning and ending asset validations
- move feed protection into separate module
- move debug log from Dashboard to Support page
- add ptm\_request parameter to redirected tracking URLs which contains a uuid
- add [fyyd.de](http://fyyd.de) module
- add option to enforce http or https in URLs inside feeds (enclosures, images) and the actual feed URLs; see `Expert Settings > Website`
- improve tracking: ignore 1-byte requests
- update user agent library (new/updated clients: Podcat, Downcast, iCatcher, BashPodder)
- show total downloads per site in network dashboard
- remove `<itunes:keywords>` from feed (it disappeared from the specification)
- remove module: “Feed Validator”
- update recommended image size to 3000x3000 pixel
- add heartbeat to keep note of when tracking is active
- `shortcode_exists($shortcode_name)` is now available in Twig templates
- system report: add notice if ALTERNATE\_WP\_CRON is active
- fix tracking export: keep httprange
- fix compatibility with other plugins relying on Spyc library
- fix `{{ episode.duration.totalMilliseconds }}`
- fix image caching issue (invisible characters)
- fix: When plugin requirements are not met, admin notices are now still shown once but the plugin is automatically deactivated after that. This avoids faulty setups.
- fix: show podcast covers in network site switcher
- fix: expert settings not saving on some systems

---

<div class="post-metadata">

**Author:** ![GeorgLohrer](https://community.podlove.org/letter_avatar_proxy/v4/letter/g/c57346/32.png) [@GeorgLohrer](https://community.podlove.org/u/GeorgLohrer)\
**Post date:** [December 6, 2016, 12:21pm UTC](https://community.podlove.org/t/release-2-4-0/771/2 "2016-12-06T12:21:51Z")

</div>

Hallo, ein Kollege hat mich darauf gebracht, die Analytic-Zahlen zu vergleichen.  
Was genau hat sich denn jetzt bei der Berechnung der Zahlen geändert.  
Wenn ich auf meine Zahlen schaue, dann zeigt mir “Total Downloads” doch eine signifikante Änderung an.  
Aus 374 Downloads in 2.3.18 sind 305 Downloads in 2.4.0 geworden.  
 ![](https://community.podlove.org/uploads/podlove/original/1X/9ff50f063873febbf307537a082e2464ecb0642f.png)  
Was stimmt denn da jetzt?  
Und wie kommt es zu der Änderung?

---

<div class="post-metadata">

**Author:** ![ericteubert](https://community.podlove.org/user_avatar/community.podlove.org/ericteubert/32/1568_2.png) [@ericteubert](https://community.podlove.org/u/ericteubert)\
**Post date:** [December 6, 2016, 1:11pm UTC](https://community.podlove.org/t/release-2-4-0/771/3 "2016-12-06T13:11:23Z")

</div>

> [@GeorgLohrer](#):
>
> Was stimmt denn da jetzt?

Näher an der Wahrheit sind die 2.4.0 Werte.

> [@GeorgLohrer](#):
>
> Und wie kommt es zu der Änderung?

Wir haben die Erkennung nicht zählenswürdiger Downloads verbessert. Es werden mehr Bots und ungültige Zugriffe als solche erkannt und von der Zählung ausgeschlossen. Viele Bots schauen regelmäßig vorbei, weshalb die Ratio bei dir um so kleiner ist, je älter die Episode.

---

<div class="post-metadata">

**Author:** ![GeorgLohrer](https://community.podlove.org/letter_avatar_proxy/v4/letter/g/c57346/32.png) [@GeorgLohrer](https://community.podlove.org/u/GeorgLohrer)\
**Post date:** [December 6, 2016, 2:00pm UTC](https://community.podlove.org/t/release-2-4-0/771/4 "2016-12-06T14:00:15Z")

</div>

Danke für Deine schnelle Antwort Eric.

Wo finde ich denn den code-Teil, der diese Kriterien implementiert?

---

<div class="post-metadata">

**Author:** ![ericteubert](https://community.podlove.org/user_avatar/community.podlove.org/ericteubert/32/1568_2.png) [@ericteubert](https://community.podlove.org/u/ericteubert)\
**Post date:** [December 6, 2016, 2:39pm UTC](https://community.podlove.org/t/release-2-4-0/771/5 "2016-12-06T14:39:53Z")

</div>

SQL Query für die “Bereinigung” von Download-Intents: [https://github.com/podlove/podlove-publisher/blob/master/lib/jobs/download\_intent\_cleanup\_job.php#L63](https://github.com/podlove/podlove-publisher/blob/master/lib/jobs/download_intent_cleanup_job.php#L63)  
Ein wesentlicher commit: [https://github.com/podlove/podlove-publisher/commit/3f4f1b2b](https://github.com/podlove/podlove-publisher/commit/3f4f1b2b)  
Grundsätzlich bauen wir bei der Erkennung von UserAgents/Bots auf [https://github.com/piwik/device-detector](https://github.com/piwik/device-detector). Das Tool ist nicht von uns, aber ich habe schon mehrfach Daten beigesteuert, um Podcast-relevante UserAgents identifizieren zu können.

---

<div class="post-metadata">

**Author:** ![Joey](https://community.podlove.org/user_avatar/community.podlove.org/joey/32/1080_2.png) [@Joey](https://community.podlove.org/u/Joey)\
**Post date:** [December 6, 2016, 5:05pm UTC](https://community.podlove.org/t/release-2-4-0/771/6 "2016-12-06T17:05:57Z")

</div>

First of all: Thanks for all your efforts and this nice update!

I’ve found some minor issues using the Podigee player. I’ve already informed the Podigee team (cc Podlove) via e-mail.

What I’ve found (in short):

- & and ’ do not get displayed correctly.
- Chapters are starting slightly too early.
- Scrollbar in chapter-view, even if there is nothing to scroll through.
- Height of chapter-view is fixed ≈ too large if there are only a few chapters

---

<div class="post-metadata">

**Author:** ![GeorgLohrer](https://community.podlove.org/letter_avatar_proxy/v4/letter/g/c57346/32.png) [@GeorgLohrer](https://community.podlove.org/u/GeorgLohrer)\
**Post date:** [December 6, 2016, 5:26pm UTC](https://community.podlove.org/t/release-2-4-0/771/7 "2016-12-06T17:26:38Z")

</div>

Erstaunlich, was sich da alles auf der Download-Seite herumzutreiben scheint. Habe mir jetzt mal die user\_agent-table angeschaut. Und da gibt’s wirklich welche, die keines oder ein Byte herunterladen? Für was für einen Zweck denn? Um zu sehen, ob der Download noch möglich ist?

---

<div class="post-metadata">

**Author:** ![ericteubert](https://community.podlove.org/user_avatar/community.podlove.org/ericteubert/32/1568_2.png) [@ericteubert](https://community.podlove.org/u/ericteubert)\
**Post date:** [December 7, 2016, 8:33am UTC](https://community.podlove.org/t/release-2-4-0/771/8 "2016-12-07T08:33:24Z")

</div>

> [@GeorgLohrer](#):
>
> Und da gibt’s wirklich welche, die keines oder ein Byte herunterladen? Für was für einen Zweck denn?

Schwer zu sagen, warum. Vielleicht um zu testen ob der Server Byte-Ranges unterstützt? Wobei das auch einfacher geht (mit einem `HEAD` Request) Hier hat zumindest jemand das gleiche beobachtet: [HTTP Range Header and Partial Downloads - SANS Internet Storm Center](https://www.dshield.org/diary/HTTP%2BRange%2BHeader%2Band%2BPartial%2BDownloads/15100)

Ich habe gerade nachgesehen, welche Clients die 0-1 Byte Requests erzeugen. SQL Query dazu:

```sql
SELECT
  COUNT(*) cnt, ua.* 
FROM
  `wp_podlove_downloadintent` di 
  JOIN `wp_podlove_useragent` ua ON ua.id = di.user_agent_id 
WHERE `httprange` = "bytes=0-1" 
GROUP BY ua.id 
ORDER BY cnt DESC

```

Die `cnt` Spalte zählt wie häufig die Anfrage von dem Client kam. Scheint vor allem Apple-Software zu sein.

---

<div class="post-metadata">

**Author:** ![GeorgLohrer](https://community.podlove.org/letter_avatar_proxy/v4/letter/g/c57346/32.png) [@GeorgLohrer](https://community.podlove.org/u/GeorgLohrer)\
**Post date:** [December 7, 2016, 7:03pm UTC](https://community.podlove.org/t/release-2-4-0/771/9 "2016-12-07T19:03:27Z")

</div>

Hm, interessant. Scheinen nur mobile-devices zu sein. Jedenfalls bei mir. Und dann nur Browser-Zugriffe oder iTunes (selten). Von daher vielleicht jemand, der eine Episoden-website in Safari oder Chrome aufruft und dieser client überprüft, ob ein Download verfügbar ist.

---

<div class="post-metadata">

**Author:** ![GeorgLohrer](https://community.podlove.org/letter_avatar_proxy/v4/letter/g/c57346/32.png) [@GeorgLohrer](https://community.podlove.org/u/GeorgLohrer)\
**Post date:** [December 7, 2016, 7:05pm UTC](https://community.podlove.org/t/release-2-4-0/771/10 "2016-12-07T19:05:14Z")

</div>

BTW, kann es sein, dass sich bei der Analyseberechnung ein Fehler eingeschlichen hat in 2.4. Also, dass meine Episoden heruntergeladen werden glaube ich ja, aber dass jede Episode zur Hälfte heute heruntergeladen wurde, gibt mir zu denken.  
 ![](https://community.podlove.org/uploads/podlove/original/1X/cca3b82ff746b1527b3a1c1a49ba66e56dc9aacc.png)

---

<div class="post-metadata">

**Author:** ![ericteubert](https://community.podlove.org/user_avatar/community.podlove.org/ericteubert/32/1568_2.png) [@ericteubert](https://community.podlove.org/u/ericteubert)\
**Post date:** [December 8, 2016, 3:26am UTC](https://community.podlove.org/t/release-2-4-0/771/11 "2016-12-08T03:26:02Z")

</div>

> [@GeorgLohrer](#):
>
> dass jede Episode zur Hälfte heute heruntergeladen wurde, gibt mir zu denken.

“1d” ist nicht “In den letzten 24 Stunden”, sondern “Am ersten Tag nach Episoden-Veröffentlichung”. Alle Zahlen sind relativ zur Episodenveröffentlichung, damit sind sie vergleichbar.

---

<div class="post-metadata">

**Author:** ![GeorgLohrer](https://community.podlove.org/letter_avatar_proxy/v4/letter/g/c57346/32.png) [@GeorgLohrer](https://community.podlove.org/u/GeorgLohrer)\
**Post date:** [December 8, 2016, 6:49am UTC](https://community.podlove.org/t/release-2-4-0/771/12 "2016-12-08T06:49:57Z")

</div>

Ach so, na dann ergeben die Zahlen Sinn. Ist aber ein bißchen unglücklich, da das Diagramm, das sehr schön gemacht ist, sich wieder absolute Datumsangaben bezieht. Aber ich erkenne, dass man abwägen muss. Um möglichst fein granular Auskunft über die Downloads zu geben, muss man für jede Episode relativ mitwandern. Würde man das nur vom aktuellen Datum aus betrachten, wird es immer unscharfer, je weiter man zurückblickt. Vielen Dank für Deine Auskunft. Vielleicht wäre ein kleiner Hinweis auf die Bedeutung der Spalten sinnvoll. Aber jetzt werde ich das erstmal auf’s Produktivsystem aktualisieren.

---

<div class="post-metadata">

**Author:** ![Toby](https://community.podlove.org/user_avatar/community.podlove.org/toby/32/61_2.png) [@Toby](https://community.podlove.org/u/Toby)\
**Post date:** [December 8, 2016, 4:52pm UTC](https://community.podlove.org/t/release-2-4-0/771/13 "2016-12-08T16:52:02Z")

</div>

Moin Eric,

das mit den Background Jobs ist ganz, ganz großes Tennis, vielen Dank! Ich hab jetzt gar nicht so genau geschaut, um wieviel Prozent die angegebenen Download Zahlen sich verringert haben, gefühlt schon eine Menge aber vielleicht weniger als 20%. Gutes Gefühl, jetzt näher an der Wahrheit zu sein, aber noch viel besseres Gefühl, die Analytics innerhalb von Sekunden angezeigt zu bekommen, und nicht erst nach Minuten 😃

---

<div class="post-metadata">

**Author:** ![emil3000](https://community.podlove.org/letter_avatar_proxy/v4/letter/e/3da27b/32.png) [@emil3000](https://community.podlove.org/u/emil3000)\
**Post date:** [December 28, 2016, 9:49am UTC](https://community.podlove.org/t/release-2-4-0/771/14 "2016-12-28T09:49:04Z")

</div>

Hab grad auf 2.4.0 upgedatet, jetzt sind die ganzen alten Downloadzahlen weg…  
Hab ich was falsch gemacht? Oder ist das normal?  
Kann ich die Daten irgendwie wieder herstellen?

VG  
Bernd

---

<div class="post-metadata">

**Author:** ![ericteubert](https://community.podlove.org/user_avatar/community.podlove.org/ericteubert/32/1568_2.png) [@ericteubert](https://community.podlove.org/u/ericteubert)\
**Post date:** [December 29, 2016, 8:42am UTC](https://community.podlove.org/t/release-2-4-0/771/15 "2016-12-29T08:42:10Z")

</div>

Statistiken werden mit Update auf 2.4 neu berechnet. Den Status kannst du unter “Tools” verfolgen.
