Title: Random File Author: Scott Reilly Published: डिसेम्बर 21, 2004 Last modified: अप्रिल 8, 2025 --- प्लगिनहरू खोज्नुहोस् ![](https://ps.w.org/random-file/assets/banner-772x250.png?rev=837026) यो प्लगिन **वर्डप्रेसका ३ प्रमुख नवीनतम रिलीजहरूसँग परीक्षण गरिएको छैन**। यो अब सम्भवतः व्यवस्थित वा समर्थन नभएको हुन सक्छ र वर्डप्रेसका नयाँ संस्करणहरूमा प्रयोग गर्दा अनुकूलता सम्बन्धी समस्या हुन सक्छ। ![](https://ps.w.org/random-file/assets/icon-128x128.png?rev=1091134) # Random File [Scott Reilly](https://profiles.wordpress.org/coffee2code/) द्वारा [डाउनलोड गर्नुहोस्](https://downloads.wordpress.org/plugin/random-file.2.0.1.zip) * [विवरण](https://ne.wordpress.org/plugins/random-file/#description) * [समीक्षाहरू](https://ne.wordpress.org/plugins/random-file/#reviews) * [स्थापना](https://ne.wordpress.org/plugins/random-file/#installation) * [विकास](https://ne.wordpress.org/plugins/random-file/#developers) [सहायता](https://wordpress.org/support/plugin/random-file/) ## विवरण 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: * If you want to actually display the name of the random file, be sure to ‘echo’ the results: * Unless you limit the file search to only include a particular extension (via ` $extensions` argument), all files in the specified `$dir` will be under consideration for random selection * Can be run inside or outside of “the loop” Links: [Plugin Homepage](https://coffee2code.com/wp-plugins/random-file/) | [Plugin Directory Page](https://wordpress.org/plugins/random-file/) | [GitHub](https://github.com/coffee2code/random-file/) | [Author Homepage](https://coffee2code.com) ### Developer Documentation Developer documentation can be found in [DEVELOPER-DOCS.md](https://github.com/coffee2code/random-file/blob/master/DEVELOPER-DOCS.md). That documentation covers the template tags and hooks provided by the plugin. As an overview, these are the template tags provided by the plugin: * `c2c_random_file()` : Retrieves the name of a random file from a specified directory and returns information based on the file. * `c2c_random_files()` : Retrieves the name, path, or link to a specified number of randomly chosen files in a specified directory. These are the hooks provided by the plugin: * `c2c_random_file` : Filter to safely invoke `c2c_random_file()` 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. * `c2c_random_files` : Filter to safely invoke `c2c_random_files()` 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. ## स्थापना 1. Install via the built-in WordPress plugin installer. Or download and unzip `random- file.zip` inside the plugins directory for your site (typically `wp-content/plugins/`) 2. Activate the plugin through the ‘Plugins’ admin menu in WordPress 3. Make use of the `c2c_random_file()` or `c2c_random_files()` template function in your code or template (see examples below). ## प्रश्नोत्तर ### Does this plugin do dynamic random rotation within a loaded page (i.e. randomly rotating images within a loaded page)? 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. ### Does this plugin include unit tests? Yes. The tests are not packaged in the release .zip file or included in plugins. svn.wordpress.org, but can be found in the [plugin’s GitHub repository](https://github.com/coffee2code/random-file/). ## समीक्षाहरू यस प्लगिनको लागि कुनै समीक्षाहरू छैनन्। ## योगदानकर्ता र डेभलपरहरू “Random File” खुला स्रोत सफ्टवेयर हो। निम्न व्यक्तिहरूले यो प्लगिनमा योगदान गरेका छन्। योगदानकर्ताहरू * [ Scott Reilly ](https://profiles.wordpress.org/coffee2code/) [“Random File” लाई आफ्नो भाषामा अनुवाद गर्नुहोस्](https://translate.wordpress.org/projects/wp-plugins/random-file) ### विकासमा रुचि छ? [आरएसएस](https://plugins.trac.wordpress.org/log/random-file/?limit=100&mode=stop_on_copy&format=rss) द्वारा [कोड ब्राउज गर्नुहोस्](https://plugins.trac.wordpress.org/browser/random-file/), [एसभीएन रिपजिटरी](https://plugins.svn.wordpress.org/random-file/) हेर्नुहोस्, वा [विकास लग](https://plugins.trac.wordpress.org/log/random-file/) को सदस्यता लिनुहोस्। ## चेन्जलग #### 2.0.1 (2025-04-08) * Fix: Fix typos in documentation * Change: Note compatibility through WP 6.8+ * Change: Update copyright date (2025) * Unit tests: - Change: Switch uses of `assertRegExp()` to `assertMatchesRegularExpression()` for future PHPUnit 10 compatibility - Change: Explicitly define return type for overridden method #### 2.0 (2024-08-13) Highlights: This minor update features improved randomization of file selection, adds support for the extensions argument to be an array, notes compatibility through WP 6.6+, removes unit tests from release packaging, updates copyright date (2024), and other code improvements and minor changes. Details: * Change: Switch to using `wp_rand()` for more reliable randomization * Change: Allow `$extensions` argument to also accept an array of extensions * Change: Strip surrounding whitespace and leading periods from provided extensions * Change: Explicitly return false if no file could be found * Change: Switch to use a switch statement, which is more concise * Change: Use cleaner `sprintf()` approach to outputting markup * Hardening: Escape text shown via ‘hyperlink’ output (though it’s never anything other than plaintext) * Change: Note compatibility through WP 6.6+ * Change: Update copyright date (2024) * Change: Tweak filter descriptions in `readme.txt` * New: Add `.gitignore` file * Change: Remove development and testing-related files from release packaging * Unit tests: - Hardening: Prevent direct web access to `bootstrap.php` - Allow tests to run against current versions of WordPress - New: Add more unit tests - New: Add `composer.json` for PHPUnit Polyfill dependency - Change: In bootstrap, store path to plugin directory in a constant - Change: Rename a test #### 1.8.12 (2023-05-21) * New: Add DEVELOPER-DOCS.md and move hooks documentation into it * Change: Note compatibility through WP 6.3+ * Change: Update copyright date (2023) _Full changelog is available in [CHANGELOG.md](https://github.com/coffee2code/random-file/blob/master/CHANGELOG.md)._ ## मेटा * संस्करण **2.0.1** * पछिल्लो अपडेट **1 वर्ष अघि** * सक्रिय स्थापना **80+** * वर्डप्रेस संस्करण ** 2.8 वा उच्च ** * जाँच गरिएको **6.8.8** * भाषा * [English (US)](https://wordpress.org/plugins/random-file/) * ट्यागहरू * [coffee2code](https://ne.wordpress.org/plugins/tags/coffee2code/)[file](https://ne.wordpress.org/plugins/tags/file/) [files](https://ne.wordpress.org/plugins/tags/files/)[random](https://ne.wordpress.org/plugins/tags/random/) [randomize](https://ne.wordpress.org/plugins/tags/randomize/) * [उन्नत दृश्य](https://ne.wordpress.org/plugins/random-file/advanced/) ## रेटिङ्गहरू ५ मा 5 तारा। * [ 1 5-तारा समीक्षा ](https://wordpress.org/support/plugin/random-file/reviews/?filter=5) * [ 0 4-तारा समीक्षाहरू ](https://wordpress.org/support/plugin/random-file/reviews/?filter=4) * [ 0 3-तारा समीक्षाहरू ](https://wordpress.org/support/plugin/random-file/reviews/?filter=3) * [ 0 2-तारा समीक्षाहरू ](https://wordpress.org/support/plugin/random-file/reviews/?filter=2) * [ 0 1-तारा समीक्षाहरू ](https://wordpress.org/support/plugin/random-file/reviews/?filter=1) [तपाईँको समीक्षा](https://wordpress.org/support/plugin/random-file/reviews/#new-post) [सबै समीक्षाहरू हेर्नुहोस्](https://wordpress.org/support/plugin/random-file/reviews/) ## योगदानकर्ताहरू * [ Scott Reilly ](https://profiles.wordpress.org/coffee2code/) ## सहायता केही भन्नु छ? सहयोग चाहियो? [सहायता फोरम हेर्नुहोस्](https://wordpress.org/support/plugin/random-file/) ## दान गर्नुहोस् के तपाईँ यस प्लगिनको उन्नतिको लागि सहायता गर्न चाहनुहुन्छ? [ यो प्लगिनको लागि दान गर्नुहोस् ](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=6ARCFJ9TX3522)