shortcoder
Last commit date
admin
6 years ago
includes
6 years ago
languages
6 years ago
readme.txt
6 years ago
shortcoder.php
6 years ago
readme.txt
210 lines
| 1 | === Shortcoder === |
| 2 | Contributors: vaakash |
| 3 | Author URI: https://www.aakashweb.com/ |
| 4 | Plugin URI: https://www.aakashweb.com/wordpress-plugins/shortcoder/ |
| 5 | Tags: shortcode, html, javascript, shortcodes, snippets, posts, pages, widgets, insert, adsense, ads, code |
| 6 | Donate link: https://www.paypal.me/vaakash/ |
| 7 | License: GPLv2 or later |
| 8 | Requires PHP: 5.3 |
| 9 | Requires at least: 4.4 |
| 10 | Tested up to: 5.3.2 |
| 11 | Stable tag: 5.2 |
| 12 | |
| 13 | Create custom "Shortcodes" easily for HTML, JavaScript snippets and use the shortcodes within posts, pages & widgets. |
| 14 | |
| 15 | == Description == |
| 16 | |
| 17 | Shortcoder plugin allows to create a custom shortcodes for HTML, JavaScript and other snippets. Now the shortcodes can be used in posts/pages and the snippet will be replaced in place. |
| 18 | |
| 19 | = Create custom shortcodes easily = |
| 20 | 1. Give a name for the shortcode |
| 21 | 1. Paste the HTML/JavaScript as content |
| 22 | 1. Save ! |
| 23 | 1. Now insert the shortcode `[sc name="my_shortcode"]` in your post/page. |
| 24 | 1. **Voila !** You got the HTML/Javascript in your post. |
| 25 | |
| 26 | = Features = |
| 27 | |
| 28 | * Create **"custom shortcodes"** easily and use them within WordPress |
| 29 | * Use any kind of **HTML** as Shortcode content. |
| 30 | * Insert: **Custom parameters** in shortcode |
| 31 | * Insert: **WordPress parameters** in shortcode |
| 32 | * Multiple editors: Code, Visual and text modes. |
| 33 | * Globally disable the shortcode when not needed. |
| 34 | |
| 35 | = An example usage = |
| 36 | |
| 37 | 1. Create a shortcode named "adsenseAd" in the Shortcoder admin page. |
| 38 | 1. Paste the adsense code in the box given and save it. |
| 39 | 1. Use `[sc name="adsenseAd"]` in your posts and pages. |
| 40 | 1. Tada !!! the ad code is replaced and it appears in the post. |
| 41 | 1. Now you can edit the ad code at one place and the code is updated in all the locations where the shortcode is used. |
| 42 | |
| 43 | * Using this idea, shortcodes can be created for frequently used snippets. |
| 44 | * You can also add [custom parameters](https://www.aakashweb.com/docs/shortcoder-doc/) (like `%%id%%`) inside the snippets, and change it's value like `[sc name="youtube" id="GrlRADfvjII"]` |
| 45 | |
| 46 | = Resources = |
| 47 | |
| 48 | * [Documentation](https://www.aakashweb.com/docs/shortcoder-doc/) |
| 49 | * [FAQs](https://www.aakashweb.com/docs/shortcoder-doc/) |
| 50 | * [Support/Report bugs](https://www.aakashweb.com/forum/) |
| 51 | |
| 52 | == Installation == |
| 53 | |
| 54 | 1. Extract the zipped file and upload the folder `Shortcoder` to to `/wp-content/plugins/` directory. |
| 55 | 1. Activate the plugin through the `Plugins` menu in WordPress. |
| 56 | 1. Open the admin page from the "Shortcoder" link in the navigation menu. |
| 57 | |
| 58 | == Frequently Asked Questions == |
| 59 | |
| 60 | Please visit the [plugin documentation page](https://www.aakashweb.com/docs/shortcoder-doc/) for complete list of FAQs. |
| 61 | |
| 62 | = What are the allowed characters for shortcode name ? = |
| 63 | |
| 64 | Allowed characters are alphabets, numbers, hyphens and underscores. |
| 65 | |
| 66 | = My shortcode is not working in my page builder ! = |
| 67 | |
| 68 | Please check with your page builder plugin to confirm if the block/place/area where the shortcode is being used can execute shortcodes. If yes, then shortcode should work fine just like regular WordPress shortcodes. |
| 69 | |
| 70 | = My shortcode is not working ! = |
| 71 | |
| 72 | Please check the following if you notice that the shortcode content is not printed or when the output is not as expected. |
| 73 | |
| 74 | * Please verify if the shortcode content is printed. If shortcode content is not seen printed, check the shortcode settings to see if any option is enabled to restrict where and when shortcode is printed. Also confirm if the shortcode name is correct and there is no duplicate `name` attribute for the shortcode. |
| 75 | * If shortcode is printed but the output is not as expected, please try the shortcode content in an isolated environment and confirm if the shortcode content is working correctly as expected. Sometimes it might be external factors like theme, other plugin might conflict with the shortcode content being used. |
| 76 | * There is a known limitation in shortcodes API when there is a combination of unclosed and closed shortcodes. Please refer [this document](https://codex.wordpress.org/Shortcode_API#Unclosed_Shortcodes) for more information. |
| 77 | |
| 78 | == Screenshots == |
| 79 | |
| 80 | 1. Shortcoder admin page. |
| 81 | 2. Editing a shortcode. |
| 82 | 3. "Insert shortcode" popup to select and insert shortcodes. |
| 83 | 4. A shortcode inserted into post. |
| 84 | 5. Shortcoder block for Gutenberg editor. |
| 85 | 6. Shortcoder executed in the post. |
| 86 | |
| 87 | [More Screenshots](https://www.aakashweb.com/wordpress-plugins/shortcoder/) |
| 88 | |
| 89 | == Changelog == |
| 90 | |
| 91 | = 5.2 = |
| 92 | * New: Default values can now be provided to custom parameters. |
| 93 | * Fix: Script tags, custom field placeholder and backslash being stripped after saving the shortcode sometimes. |
| 94 | * Fix: Rel attribute being modified for links. |
| 95 | * New: Added "Manage shortcodes" link to plugin list page for easy access after activation. |
| 96 | |
| 97 | = 5.1 = |
| 98 | * New: Import/Export link added to the shortcoder list page. |
| 99 | * Fix: `empty()` was throwing error at some places for users using PHP 5.5 below as function return value was passed to it. |
| 100 | * Fix: Shortcoder QTTags button was loading in frontends. |
| 101 | * Fix: "Insert shortcode" popup was hidden behind in theme customizer page. |
| 102 | * Fix: `array_key_exists` array but bool given warning. |
| 103 | * Fix: Hide comments metabox in shortcode edit page as it was shown in certain conditions. |
| 104 | |
| 105 | = 5.0.4 = |
| 106 | * Fix: `script` and `style` tags stripped after 4.x upgrade. New migration will run in this version and shortcode content will now be fixed. |
| 107 | |
| 108 | = 5.0.3 = |
| 109 | * Fix: Shortcode content is not escaped when code editor is used. This is requirement because `post_content` behaves strangely when user has rich editing enabled. |
| 110 | |
| 111 | = 5.0.2 = |
| 112 | * Fix: Shortcodes inside shortcode content not getting executed. |
| 113 | * Fix: Disable Gutenberg block for older not supported WordPress versions. |
| 114 | |
| 115 | = 5.0.1 = |
| 116 | * Fix: Code editor escaping HTML characters. |
| 117 | * Fix: `get_current_screen()` undefined. |
| 118 | * Fix: Code editor breaks if there is any other plugin which loads codemirror. |
| 119 | * Fix: `tools.php` is not found. |
| 120 | |
| 121 | = 5.0 = |
| 122 | * New: Brand new version. Plugin rewritten from scratch. |
| 123 | * New: Shortcoder block for the block editor. |
| 124 | |
| 125 | = 4.4 = |
| 126 | * New: Insert shortcode automatically adds "closing tag" if the shortcode has enclosed content parameter. |
| 127 | * Fix: Codemirror has been updated to latest version. |
| 128 | |
| 129 | = 4.3 = |
| 130 | * New: Edit shortcode name after creating. |
| 131 | * New: Post modified date parameter added. |
| 132 | * Fix: Date parameters now display in site language. |
| 133 | |
| 134 | = 4.2 = |
| 135 | * Fix: Some plugins fail to fire onload JS event since it was overwritten by shortcoder. |
| 136 | * Fix: Javascript in insert shortcode popup not working in IE 11. |
| 137 | * Fix: Missing parenthesis while calling `is_year`. |
| 138 | * Fix: Widgets page not loading insert shortcode popup. |
| 139 | * Fix: Removed settings emoji icon from plugin actions list. |
| 140 | * Fix: Load latest version 5.42.0 of codemirror. |
| 141 | * Fix: Updated minimum required WordPress version. |
| 142 | |
| 143 | = 4.1.9 = |
| 144 | * Fix: Minor UI refinements for better experience. |
| 145 | * Fix: Import error where some exported JSON files have 0 as EOF. |
| 146 | |
| 147 | = 4.1.8 = |
| 148 | * New: Insert custom fields in shortcode content. |
| 149 | * Fix: Removed comments in shortcode output |
| 150 | |
| 151 | = 4.1.7 = |
| 152 | * New: Categorize, search and filter shortcodes using "tags". |
| 153 | * New: Last used shortcode editor will be saved along with shortcode. |
| 154 | * New: Enclosed shortcode content can now be used as shortcode parameter. |
| 155 | * New: Active line highlight has been enabled for code editor. |
| 156 | * Fix: Codemirror has been updated to latest version. |
| 157 | * Fix: Minor admin interface enhancements. |
| 158 | |
| 159 | = 4.1.6 = |
| 160 | * New: Date variables can noe be added into shortcode content. |
| 161 | * Fix: Error "trying to get property of non-object" is handled. |
| 162 | |
| 163 | = 4.1.5 = |
| 164 | * New: Bloginfo variables can now be added into shortcode content. |
| 165 | |
| 166 | = 4.1.4 = |
| 167 | * New: Codemirror powered syntax highlighted shortcode content code editor (beta). |
| 168 | |
| 169 | = 4.1.3 = |
| 170 | * Fix: Shortcode names with not-allowed characters cannot be edited/deleted. |
| 171 | * New: Shortcode imports made can now be fresh or overwritten. |
| 172 | * New: Only users with `manage_options` capability will see "edit shortcode" option in insert window. |
| 173 | * Fix: Import failure with UTF-8 characters. |
| 174 | * Fix: Case sensitive search in admin pages. |
| 175 | * Fix: Minor admin interface changes. |
| 176 | |
| 177 | = 4.1.2 = |
| 178 | * New: Search box for shortcodes in admin page. |
| 179 | |
| 180 | = 4.1.1 = |
| 181 | * Fix: HTTP 500 error because of syntax error in import module. |
| 182 | |
| 183 | = 4.1 = |
| 184 | * New: Import/export feature for shortcodes. |
| 185 | * Fix: Visual editor is now disabled by default. |
| 186 | * Fix: Added instructions in admin page. |
| 187 | |
| 188 | = 4.0.3 = |
| 189 | * New: Added feature to sort created shortcodes list. |
| 190 | * Fix: HTML errors in admin page |
| 191 | |
| 192 | = 4.0.2 = |
| 193 | * Fix: Sometimes `get_current_screen()` was called early in some setups. |
| 194 | |
| 195 | = 4.0.1 = |
| 196 | * Fix: Servers with PHP version < 5.5 were facing HTTP 500 error because of misuse of PHP language construct in code. |
| 197 | |
| 198 | = 4.0 = |
| 199 | * New: Plugin rewritten from scratch. |
| 200 | * New: Brand new administration page |
| 201 | * New: Shortcode vissibility settings, show/hide in desktop/mobile devices |
| 202 | * New: Insert WordPress information into shortcode content. |
| 203 | * Fix: Insert shortcode window is not loading. |
| 204 | * Fix: Unable to delete the shortcodes |
| 205 | |
| 206 | (Older changelogs are removed from this list) |
| 207 | |
| 208 | == Upgrade Notice == |
| 209 | |
| 210 | Version 5.0 is a major release. |