Trivial update: fixed some typos in documentation, noted compatibility through WP 6.8+, and updated copyright date (2025).<\/p>","2.0":"
Minor update: improved randomization of file selection, added support for the extensions arugment to be an array, noted compatibility through WP 6.6+, removed unit tests from release packaging, updated copyright date (2024), and other code improvements and minor changes<\/p>","1.8.12":"
Trivial update: added DEVELOPER-DOCS.md, noted compatibility through WP 6.3+, and updated copyright date (2023)<\/p>","1.8.11":"
Trivial update: noted compatibility through WP 5.8+ and minor reorganization and tweaks to unit tests<\/p>","1.8.10":"
Trivial update: noted compatibility through WP 5.7+ and updated copyright date (2021).<\/p>","1.8.9":"
Trivial update: Restructured unit test file structure, added a TODO.md file, and noted compatibility through WP 5.5+.<\/p>","1.8.8":"
Trivial update: Updated a few URLs to be HTTPS and noted compatibility through WP 5.4+.<\/p>","1.8.7":"
Trivial update: noted compatibility through WP 5.3+ and updated copyright date (2020)<\/p>","1.8.6":"
Trivial update: modernized unit tests, noted compatibility through WP 5.2+<\/p>","1.8.5":"
Trivial update: noted compatibility through WP 5.1+, updated copyright date (2019)<\/p>","1.8.4":"
Trivial update: noted compatibility through WP 4.9+, added README.md for GitHub, and updated copyright date (2018)<\/p>","1.8.3":"
Recommended minor update: fixed inccorect name of variable, noted compatibility through WP 4.7+, updated copyright date<\/p>","1.8.2":"
Trivial update: noted compatibility through WP 4.4+ and updated copyright date (2016)<\/p>","1.8.1":"
Trivial update: noted compatibility through WP 4.1+ and updated copyright date (2015)<\/p>","1.8":"
Recommended minor update: fixed bug which prevented specified multiple file extensions from working; added unit tests; noted compatibility through WP 3.8+<\/p>","1.7.1":"
Trivial update: noted compatibility through WP 3.5+<\/p>","1.7":"
Recommended minor update: improved compatibility and data sanitization; noted compatibility through WP 3.4+; explicitly stated license<\/p>","1.6.2":"
Trivial update: noted compatibility through WP 3.3+<\/p>","1.6.1":"
Trivial update: noted compatibility through WP 3.2+<\/p>","1.6":"
Feature update. Highlights: added c2c_random_files() to retrieve array of random unique files; added hooks to allow customizations; verified WP 3.0 compatibility.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":"1"},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":1091134,"resolution":"128x128","location":"assets","locale":""}},"assets_banners":{"banner-772x250.png":{"filename":"banner-772x250.png","revision":837026,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0","1.5","1.5.1","1.5.2","1.6","1.6.1","1.6.2","1.7","1.7.1","1.8","1.8.1","1.8.10","1.8.11","1.8.12","1.8.2","1.8.3","1.8.4","1.8.5","1.8.6","1.8.7","1.8.8","1.8.9","2.0","2.0.1"],"block_files":[],"assets_screenshots":[],"screenshots":[],"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[2758,260,88,244,3790],"plugin_category":[],"plugin_contributors":[78189],"plugin_business_model":[],"class_list":["post-1565","plugin","type-plugin","status-publish","hentry","plugin_tags-coffee2code","plugin_tags-file","plugin_tags-files","plugin_tags-random","plugin_tags-randomize","plugin_contributors-coffee2code","plugin_committers-coffee2code"],"banners":{"banner":"https:\/\/ps.w.org\/random-file\/assets\/banner-772x250.png?rev=837026","banner_2x":false,"banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/random-file\/assets\/icon-128x128.png?rev=1091134","icon_2x":false,"generated":false},"screenshots":[],"raw_content":"\n
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.<\/p>\n\n
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.<\/p>\n\n
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.<\/p>\n\n
Notes:<\/p>\n\n
If you want to actually display the name of the random file, be sure to 'echo' the results:\n<\/p><\/li>\n
Unless you limit the file search to only include a particular extension (via Can be run inside or outside of \"the loop\"<\/p><\/li>\n<\/ul>\n\n Links: Plugin Homepage<\/a> | Plugin Directory Page<\/a> | GitHub<\/a> | Author Homepage<\/a><\/p>\n\n Developer documentation can be found in DEVELOPER-DOCS.md<\/a>. That documentation covers the template tags and hooks provided by the plugin.<\/p>\n\n As an overview, these are the template tags provided by the plugin:<\/p>\n\n These are the hooks provided by the plugin:<\/p>\n\n No. This plugin only selects a random file when the page is loaded. Once loaded, it does not currently add any dynamic functionality to automatically retrieve another random file on its own.<\/p><\/dd>\n$extensions<\/code> argument), all files in the specified $dir<\/code> will be under consideration for random selection<\/p><\/li>\nDeveloper Documentation<\/h3>\n\n
\n
c2c_random_file()<\/code> : Retrieves the name of a random file from a specified directory and returns information based on the file.<\/li>\nc2c_random_files()<\/code> : Retrieves the name, path, or link to a specified number of randomly chosen files in a specified directory.<\/li>\n<\/ul>\n\n\n
c2c_random_file<\/code> : Filter to safely invoke 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>\nc2c_random_files<\/code> : Filter to safely invoke 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>\n<\/ul>\n\n\n\n
random-file.zip<\/code> inside the plugins directory for your site (typically wp-content\/plugins\/<\/code>)<\/li>\nc2c_random_file()<\/code> or c2c_random_files()<\/code> template function in your code or template (see examples below).<\/li>\n<\/ol>\n\n\n\n
Does this plugin do dynamic random rotation within a loaded page (i.e. randomly rotating images within a loaded page)?<\/h3><\/dt>\n
Does this plugin include unit tests?<\/h3><\/dt>\n