Description
Use Snippy to quickly create your own custom shortcodes.
A Snippy shortcode is built by combining bits. A bit can be a file, like a Stylesheet or a Script, or a piece of code, like HTML, CSS or JavaScript.
The βcodeβ bits can contain placeholders, which are automatically made accessible as shortcode attributes.
Time for a quick example.
Let’s create a shortcode to embed YouTube videos. We’ll add an HTML bit and set the it’s value to the YouTube embed iframe.
<iframe src="https://youtube/embed/JZYYJY4yoK4"/>
Now to make this bit a bit more flexible we will replace the YouTube video id with a placeholder value {{id}}
.
<iframe src="https://youtube/embed/{{id}}"/>
Yay! We’ve finished our first bit!
Now we can create a new Snippy shortcode and add the YouTube iFrame HTML bit. After saving the shortcode we can use our new and shiny YouTube shortcode in the text editor.
[youtube id=JZYYJY4yoK4]
Ready for more?
The below 3 minute YouTube video shows how you can use Snippy to turn a jQuery plugin into a WordPress plugin.
Screenshots
Installation
- Download the zip file.
- Log into WordPress, hover over Plugins and click Add new
- Click on the Upload Plugin button.
- Select the zip file you downloaded.
- Click Install Plugin.
- Click Activate.
- Navigate to the βSnippyβ menu on the left and setup your first shortcode.
FAQ
- Can I use JavaScript or CSS files instead of HTML
-
Yes, you can select JS and CSS files to be added to a bit, Snippy will automatically load the files when the shortcode is used on a page.
Please note that your server might prevent uploading files with a .js or .css extension. If that’s the case you have to alter the server security settings to allow uploading of these files.
- How do I define placeholders
-
You can define placeholders in bits by wrapping text in brackets like this:
{{placeholder}}
.Suppose you want to create a placeholder for a YouTube video. You’d replace the YouTube video id with
{{id}}
.<iframe src="https://youtube/embed/{{id}}"/>
Now the attribute id is available in any shortcode that uses the YouTube HTML bit.
[youtube id=JZYYJY4yoK4]
- How do I set a placeholder default value
-
Placeholder default values can be set by following the placeholder name with a semicolon and then the default value.
{{name:John Doe}}
- Which default placeholders can I use
-
The following list of placeholders have a special function:
{{content}}
is always replaced with the content wrapped by your shortcode.{{date_today}}
is replaced with an ISO8601 representation of today’s date.{{date_tomorrow}}
is replaced with an ISO8601 representation of today’s date.{{unique_id}}
is replaced with a uniquely generated id.{{shortcode_id}}
is replaced with the id of the current shortcode.{{bit_id}}
is replaced with the id of the current bit.{{page_id}}
is replaced with the current page id.{{page_relative_url}}
relative url to the current page.{{page_absolute_url}}
absolute url to the current page (includes the domain).{{theme}}
current theme name.{{theme_root_uri}}
theme directory URI.{{template_directory_uri}}
current theme directory URI.{{admin_url}}
current admin url.{{nonce_field:action,name}}
generate a nonce field.
Reviews
Contributors & Developers
“Snippy” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Snippy” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.4.1
- Test with WordPress 5.3
1.4.0
- Add
{{admin_url}}
and{{nonce_field}}
placeholders.
1.3.5
- Fixed problem where snippy shortcode menu was rendered before doctype
1.3.4
- Fixed problem where paging would not work
1.3.3
- Tested with WordPress 5.0.0
1.3.0
- When using multiple placeholders with the same name, they will only show up once
- Add
bit_id
andshortcode_id
placeholders
1.2.0
- HTML bits can now contain shortcodes
- Add more placeholders
1.1.1
- Fix problem where shortcode and bits tables would not show paging control
1.1.0
- Add βlocalβ or βremoteβ resource bit which makes possible the option to include CDN resources.
- Add a starter set of dynamic placeholders
- Only admin can now edit Snippy shortcodes
1.0
- Initial release