WordPlay is a free WordPress® plugin that lets you display a random WordPress® meme from an included set of 21 images.
Whether on the front-end using widgets or shortcodes, or on the dashboard with a custom widget, WordPlay brings a little randomness and joy to your website that just so happens to be powered by WordPress®.
- Dashboard Widget: A custom dashboard widget that displays a random meme in the WordPress® admin area.
- Frontend Widget: A sidebar widget that users can add to any widgetized area of their website to show a random meme.
- Shortcode: A shortcode
[wordplay]
that displays a random meme anywhere within posts or pages.
- Download the
WordPlay
plugin from the GitHub repository. - In your WordPress® Admin Dashboard, navigate to Plugins > Add New.
- Click Upload Plugin, then select the
WordPlay.zip
file you downloaded. - Click Install Now, then activate the plugin after installation.
- Download the plugin from the GitHub repository.
- Unzip the file and upload the
wordplay
folder to the/wp-content/plugins/
directory. - Activate the plugin in the Plugins menu within the WordPress® Admin Dashboard.
- After activating the plugin, navigate to your WordPress® admin dashboard.
- You'll see a new widget titled WordPlay Random Image on your dashboard, displaying a random meme from the plugin.
2. Frontend Widget
< 841E /div>- Go to Appearance > Widgets in your WordPress® admin area.
- Drag the WordPlay widget to any widget area (e.g., Sidebar or Footer).
- The widget will display a random meme from the plugin's image folder on the frontend.
-
Use the shortcode
[wordplay]
to display a random meme in any page or post. -
Example usage:
[wordplay]
-
You can add this shortcode anywhere in the editor, and it will output a random meme.
Currently, the plugin comes with a set of 21 memes included in the public/assets/img/
folder. You can replace these images with your own to customize the memes displayed by the plugin. Just make sure they use one of the supported formats (.jpg
, .jpeg
, .png
, .gif
, .webp
).
- Navigate to the folder:
public/assets/img/
. - Replace the images with your own, maintaining the existing image names if possible.
- You can add more images to the
public/assets/img/
folder. The plugin will automatically detect and include them in the random image rotation.
- Yes! The plugin supports
.jpg
,.jpeg
,.png
,.gif
, and.webp
formats.
-
Yes, simply enable the Shortcode in Widgets option by adding the following code to your theme's
functions.php
:add_filter('widget_text', 'do_shortcode');
We welcome contributions to enhance this plugin! Here's how you can contribute:
-
Fork the repository on GitHub.
-
Clone your fork locally:
-
Create a new branch for your feature or bug fix:
git checkout -b feature-name
-
Commit your changes:
git commit -m "Add a meaningful commit message"
-
Push your changes to your fork:
git push origin feature-name
-
Open a Pull Request to the
main
branch of the original repository.
This project is licensed under the GPLv2 License. See the LICENSE file for details.
Robert DeVore WordPlay - Bringing random joy to WordPress® sites, one meme at a time 🤘