https://github.com/reindernijhoff/wp-shadertoy-gallery
This Wordpress plugin enables a shortcode that can be used to add a gallery with Shadertoy shaders to your Worpress site.
https://github.com/reindernijhoff/wp-shadertoy-gallery
gallery shadertoy shortcode wordpress wordpress-plugin
Last synced: 29 days ago
JSON representation
This Wordpress plugin enables a shortcode that can be used to add a gallery with Shadertoy shaders to your Worpress site.
- Host: GitHub
- URL: https://github.com/reindernijhoff/wp-shadertoy-gallery
- Owner: reindernijhoff
- License: mit
- Created: 2019-09-01T17:27:57.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2024-04-02T10:26:16.000Z (about 2 years ago)
- Last Synced: 2025-10-22T22:38:36.146Z (8 months ago)
- Topics: gallery, shadertoy, shortcode, wordpress, wordpress-plugin
- Language: PHP
- Homepage: https://reindernijhoff.net/shadertoy/
- Size: 11.7 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Wordpress Shadertoy Gallery Plugin
This WordPress plugin enables a shortcode that can be used to add a gallery with [Shadertoy](https://www.shadertoy.com) shaders to your WordPress site. The content of the gallery is based on a _query_ attribute of the shortcode. The content of the gallery will update automatically.
You can find a live demo of this plugin [here](https://reindernijhoff.net/shadertoy/).
Note:
- This is the first WordPress plugin I have ever made.
- You *need* a Shadertoy API key for this plugin. You can request a key [here](https://www.shadertoy.com/howto).
- The plugin can only find and display shaders published on Shadertoy using the _API+Public_ option.
I don't want to DDoS Shadertoy, and I want a fast plugin. Therefore, many results are cached: the result of a query will be cached for (at least) one day, the title of an individual shader for (at least) 14 days. Expect a (extremely) long page load the first time you open the Gallery. A second time (most) will be cached, and you should respond quickly.
## Installation
Copy the _shadertoy_ directory into _wp-content/plugins_ and activate the plugin in the Admin.
## Basic usage
Add a _shadertoy-list_ shortcode to your post or page. If you want to create a gallery with all shaders that match the query 'raymarch', you use:
```
[shadertoy-list query="raymarch" key="YOUR_SHADERTOY_API_KEY_HERE"]
```
## Optional attributes
You can use the following (optional) attributes:
- *query* - The query term.
- *key* - Your Shadertoy API key.
- *username* (optional) - Only shaders created by the user with this username will be visible.
- *columns* (optional, default = 2) - Number of columns of the gallery. Values 1,2,3 and 4 are supported.
- *sort* (optional, default = newest) - Order of the the shaders. Supported values: "name", "love", "popular", "newest", "hot".