Description
Shortcake Bakery adds a fine selection of shortcodes to your WordPress site. Use with Shortcake for the optimal experience.
The following shortcodes are now available for your use within the content field:
- ABC_News
[abc-news]
- Facebook
[facebook]
- Flickr
[flickr]
- Giphy
[giphy]
- GoogleDocs
[googledocs]
(Includes several common formats: Documents, Spreadsheets, Presentations, Forms, Maps, and Fusion Tables.) - Guardian
[guardian]
- Image Comparison
[image-comparison]
(Uses the juxtapose.js script from Knight Labs.) - Infogram
[infogram]
- Instagram
[instagram]
- Live Photo
[live-photo]
- Livestream
[livestream]
- PDF Viewer
[pdf]
(PDF documents can be uploaded attachments or remotely hosted documents. A code-based proxy pass can be made available for external documents with a filter.) - Playbuzz
[playbuzz]
- Rap_Genius
[rap-genius]
- Scribd
[scribd]
- Script
[script]
(Requires code-level configuration of accepted domains.) - Silk
[silk]
- SoundCloud
[soundcloud]
- Twitter
[twitter]
- Videoo
[videoo]
- Vimeo
- Vine
[vine]
- YouTube
- iFrame
[iframe]
(Requires code-level configuration of accepted domains.)
Shortcake Bakery also enables an โAdd Embed Codeโ experience for Shortcake shortcodes. Clicking the โAdd Embed Codeโ media button will display a form in the media modal where a user can paste an embed code as received from a provider (by copying the embed code from a YouTube video, for one example). If that embed code matches a shortcode registered with the Shortcake Bakery shortcode API, the matched shortcode will be sent to the editor.
See the Installation section for code-level configuration details. Get involved with the project and submit your own shortcodes on Github.
Screenshots
Installation
It’s a plugin! Install it like any other.
Most of the shortcodes work out of the box, but you’ll need to whitelist any domains you want to be eligible for script and iFrame tag use.
add_filter( 'shortcake_bakery_whitelisted_script_domains', function(){
return array(
'ajax.googleapis.com',
);
});
add_filter( 'shortcake_bakery_whitelisted_iframe_domains', function(){
return array(
'buzzfeed.com',
);
});
If you don’t want to enable all of the shortcodes which are bundled with this plugin, you can filter them by returning a smaller array from the filter โshortcake_bakery_shortcode_classesโ:
add_filter( 'shortcake_bakery_shortcode_classes', function() {
return array(
'Shortcake_Bakery\Shortcodes\Facebook',
'Shortcake_Bakery\Shortcodes\Twitter',
'Shortcake_Bakery\Shortcodes\YouTube',
);
});
Because of cross-domain issues, the [pdf]
shortcode will only work out of the box with PDFs uploaded as local attachments, or that are served with appropriate Cross-Origin Resource Sharing headers. (If you don’t know about the domain you’re hosting the PDFs on, most likely it doesn’t include these headers and as a result, the PDF will not render properly on the front end.)
If you need to be able to serve pdf documents from other domains, you will need to set up an asset proxy for them. We have a basic PHP-based asset proxy built in to the plugin, which is disabled by default. If you want to enable it, return true from the following filter:
add_filter( 'shortcake_bakery_pdf_enable_cors_proxy', '__return_true' );
This feature should be enabled only with conscious thought, though, as if this is used heavily, it has the potential to cause serious performance issues. If you will be serving many, or very large PDFs, we recommend building your own proxy for these – using an nginx proxy_pass directive, for example.
FAQ
- Installation Instructions
-
It’s a plugin! Install it like any other.
Most of the shortcodes work out of the box, but you’ll need to whitelist any domains you want to be eligible for script and iFrame tag use.
add_filter( 'shortcake_bakery_whitelisted_script_domains', function(){ return array( 'ajax.googleapis.com', ); }); add_filter( 'shortcake_bakery_whitelisted_iframe_domains', function(){ return array( 'buzzfeed.com', ); });
If you don’t want to enable all of the shortcodes which are bundled with this plugin, you can filter them by returning a smaller array from the filter โshortcake_bakery_shortcode_classesโ:
add_filter( 'shortcake_bakery_shortcode_classes', function() { return array( 'Shortcake_Bakery\Shortcodes\Facebook', 'Shortcake_Bakery\Shortcodes\Twitter', 'Shortcake_Bakery\Shortcodes\YouTube', ); });
Because of cross-domain issues, the
[pdf]
shortcode will only work out of the box with PDFs uploaded as local attachments, or that are served with appropriate Cross-Origin Resource Sharing headers. (If you don’t know about the domain you’re hosting the PDFs on, most likely it doesn’t include these headers and as a result, the PDF will not render properly on the front end.)If you need to be able to serve pdf documents from other domains, you will need to set up an asset proxy for them. We have a basic PHP-based asset proxy built in to the plugin, which is disabled by default. If you want to enable it, return true from the following filter:
add_filter( 'shortcake_bakery_pdf_enable_cors_proxy', '__return_true' );
This feature should be enabled only with conscious thought, though, as if this is used heavily, it has the potential to cause serious performance issues. If you will be serving many, or very large PDFs, we recommend building your own proxy for these – using an nginx proxy_pass directive, for example.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Shortcake Bakery” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Shortcake Bakery” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
0.2.0 (April 17, 2017)
This release includes 14 new shortcodes, and some major new features for users.
- Add โAdd embedโ media button; allow users to enter an arbitrary code from a provider, and convert it to a shortcode if that shortcode is available (as defined by the shortcode’s โreversalโ method). Developers: note that this only works with shortcodes that extend \Shortcode_Bakery\Shortcode and implement the reversal()โ method. You may also disable this button using the
shortcake_bakery_show_add_embed
filter. - Updated the format of Instagram embeds.
- Added several new URL patterns for Facebook embeds. Groups, Pages, and videos are now supported in addition to Posts.
- New shortcode:
[soundcloud]
Shortcode for Soundcloud embeds. - New shortcode:
[abc-news]
Shortcode for ABC News embeds. - New shortcode:
[flickr]
Shortcode for Flickr embeds. - New shortcode:
[giphy]
Shortcode for Giphy embeds. - New shortcode:
[google-docs]
Shortcode for Google Docs embeds. - New shortcode:
[guardian]
Shortcode for embeds from The Guardian. - New shortcode:
[instagram]
Shortcode for Instagram embeds. - New shortcode:
[live-photo]
Shortcode for Apple Live Photo embeds. - New shortcode:
[livestream]
Shortcode for Livestream embeds. - New shortcode:
[pdf]
Embed local or external PDF documents using pdf.js. - New shortcode:
[silk]
Shortcode for Silk embeds - New shortcode:
[videoo]
Shortcode for Videoo embeds. - New shortcode:
Shortcode for Vimeo embeds.
- New shortcode:
[vine]
Shortcode for Vine embeds. - Improved UI for selecting post elements; consistant icons for all embeds.
- Bug fix: Allow Giphy embeds with hyp0hens in URLs.
- Added Japanese translation
- Allow the source of iframe and script embeds to be filtered, for SSL compatability.
0.1.0 (July 17, 2015)
- Initial release.
- Full release notes