=== Snippy ===
Contributors: pqina
Donate link: https://codecanyon.net/user/pqina/portfolio?ref=pqina
Tags: shortcode, short code, custom, build, create, edit, javascript, jquery, plugin
Requires at least: 4.5
Tested up to: 4.8
Stable tag: trunk
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Makes it easy to create your own custom shortcodes.


== 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/S7JjNq6feK0"/>`

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=S7JjNq6feK0]]`

*Ready for more?*

The below 3 minute YouTube video shows how you can use Snippy to turn a jQuery plugin into a WordPress plugin.

<iframe src="https://youtube.com/embed/S7JjNq6feK0"></iframe>


== Installation ==

1. Download the zip file.
1. Log into WordPress, hover over *Plugins* and click *Add new*
1. Click on the *Upload Plugin* button.
1. Select the zip file you downloaded.
1. Click *Install Plugin*.
1. Click *Activate*.
1. Navigate to the 'Snippy' menu on the left and setup your first shortcode.


== Frequently Asked Questions ==

= 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.


= 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=S7JjNq6feK0]]`


= 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}}`


== Screenshots ==

1. Creating an HTML bit containing a YouTube iframe snippet and setting the `{{id}}` placeholder.
2. Creating a `[youtube]` shortcode that makes use of the YouTube iframe snippet.
3. Adding the shortcode to the page and setting a YouTube video id.

== Upgrade Notice ==

Test


== Changelog ==

= 1.0 =
* Initial release