Scott Reilly

This plugin provides template tags that allow you to retrieve the name, path (relative or absolute), url, or fully marked-up link to a randomly chosen file or files in a specified directory.
Arguments to the functions permit you to limit what file(s) can be randomly selected based on a given set of file extensions. You can also explicitly specify files that should not be randomly selected.
This functionality can be useful for displaying random images/logos or including text from random files onto your site (writing excerpts, multi-line quotes, etc). Other ideas: random ads, random CSS files, random theme template selection.
Notes:
<ul>
<li>
If you want to actually display the name of the random file, be sure to ‘echo’ the results:

</li>
<li>
Unless you limit the file search to only include a particular extension (via <code>$extensions</code> argument), all files in the specified <code>$dir</code> will be under consideration for random selection
</li>
<li>
Can be run inside or outside of “the loop”
</li>
</ul>
Links: <a href="https://coffee2code.com/wp-plugins/random-file/" rel="nofollow ugc">Plugin Homepage</a> | <a href="https://wordpress.org/plugins/random-file/" rel="ugc">Plugin Directory Page</a> | <a href="https://github.com/coffee2code/random-file/" rel="nofollow ugc">GitHub</a> | <a href="https://coffee2code.com" rel="nofollow ugc">Author Homepage</a>
<h3>Developer Documentation</h3>
Developer documentation can be found in <a href="https://github.com/coffee2code/random-file/blob/master/DEVELOPER-DOCS.md" rel="nofollow ugc">DEVELOPER-DOCS.md</a>. That documentation covers the template tags and hooks provided by the plugin.
As an overview, these are the template tags provided by the plugin:
<ul>
<li><code>c2c_random_file()</code> : Retrieves the name of a random file from a specified directory and returns information based on the file.</li>
<li><code>c2c_random_files()</code> : Retrieves the name, path, or link to a specified number of randomly chosen files in a specified directory.</li>
</ul>
These are the hooks provided by the plugin:
<ul>
<li><code>c2c_random_file</code> : Filter to safely invoke <code>c2c_random_file()</code> in such a way that if the plugin were deactivated or deleted, then your calls to the function won’t cause errors in your site.</li>
<li><code>c2c_random_files</code> : Filter to safely invoke <code>c2c_random_files()</code> in such a way that if the plugin were deactivated or deleted, then your calls to the function won’t cause errors in your site.</li>
</ul>

Random File

Retrieve the name, path, or link to a randomly chosen file or files in a specified directory.

Ralf

WP-Stadtklick ist ein Plugin, um die Aktion “Lass den Klick in deiner Stadt” in WordPress zu integrieren. Die Aktion mancher lokaler Buchhändler will darauf aufmerksam machen, dass man Bücher online nicht nur bei Amazon, sondern auch in Online-Shops der Buchläden vor Ort kaufen kann.
Will man nun auf ein Buch im Blog verlinken, steht man dabei vor dem Problem, dass man sich entweder für den Webshop eines Buchladens entscheiden oder eine länger Liste mit Links zu allen regionalen Webshops erstellen müsste.
Das Plugin bietet die Möglichkeit, als einem Artikel auf ein Buch zu verlinken – zufällig in einem Online-Shop eines Buchladens.
<ul>
<li><a href="http://buylocal-wuerzburg.de/" rel="nofollow ugc">Website “Lass den Klick in deiner Stadt, Würzburg”</a></li>
<li><a href="https://github.com/rthees/wp-stadtklick" rel="nofollow ugc">WP-StadtKlick bei GitHub</a></li>
</ul>
<h3>Anwendung</h3>
<h4>Einstellungen</h4>
In den Einstellungen muss man mindestens einen Online-Shop anlegen. Dazu besucht man die Online-Shops der Buchhandlungen, die man als Links anbieten will. Man braucht nun die URL auf ein bestimmtes Buch, in der auch die ISBN-Nummer enthalten ist. Das geht je nach Shop-System mehr oder weniger einfach. 
Manchmal kann man auch nur auf die Seite der Ergebnisse bei einer ISBN-Suche verlinken.
Hat man eine URL mit ISBN gefunden, trägt man diese in die Einstellungen von WP-Stadtklick ein und ersetzt die echte ISBN mit dem Platzhalter %%isbn%%. 
Das könnte so aussehen: http://ralfsbuchladen.de/shop/detail.php?desc=full&ean=%%isbn%%
<ul>
<li><a href="https://gist.github.com/rthees/6257484" rel="nofollow ugc">Beispiele für Online-Shops von Buchhandlungen in Würzburg</a></li>
</ul>
<h4>Links auf Bücher im Artikel erzeugen</h4>
Einen Link auf ein Buch setzt man per Shortcode [stadtklick] im Artikeleditor.
Beispiele:
Einen zufälligen Link auf einen der Online-Shops anzeigen, als Link-Text wird der Name in den Einstellungen verwendet: 
 [stadtklick isbn=9783862822355] 
Ob eine ISBN-10 oder ISBN-13 verwendet wird, ist egal, intern wird auf ISBN-13 umgerechnet.
Einen zufälligen Link auf einen der Online-Shops anzeigen, mit einem festen Link-Text 
 [stadtklick isbn=9783862822355 name=”Zufälliger Buchlanden”]
Alle Online-Shops mit den jeweiligen Namen als zufällig sortierte Liste ausgeben: 
 [stadtklick isbn=9783862822355 output=”list”]
<h4>Links auf Bücher für externe Nutzung erzeugen</h4>
Um “von Außen” auf ein Buch in einem zufälligen Online-Shop zu verlinken, gibt es folgende Möglichkeit:
Die “schöne” Möglichkeit ist, z.B. mit http://blogname.de/isbn/9783862822355 auf ein Buch zu verlinken. 
Das Plugin legt dazu eine Umleitung an, wenn
<ul>
<li>die WordPress-Installation Permalinks verwendet</li>
<li>die Permalinks in den Einstellungen neu gespeichert werden</li>
</ul>
Falls keine Text-Permalinks verwendet werden, kann man über den URL-Parameter “stadtklick_isbn” verlinken. So führt http://blogname.de?stadtklick_isbn=9783862822355 direkt zu einem Buch in einem zufällig ausgewählten Online-Shop.

WP-StadtKlick

Setzt einen Link auf ein Buch in einem zufällig ausgewählten Online-Shop eines Buchladens.

Random File vs WP-StadtKlick