תיאור
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.
צילומי מסך
התקנה
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.
שאלות נפוצות
- 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.
סקירות
There are no reviews for this plugin.
מפתחים
"Shortcake Bakery" הוא תוסף קוד פתוח. האנשים הבאים תרמו ליצירת התוסף הזה.
תורמיםניתן לתרגם את "Shortcake Bakery" לשפה שלך.
מעוניינים בפיתוח?
עיינו בקוד, ראו את הקוד ב-SVN repository, או הירשמו ללוג פיתוח באמצעות RSS.
שינויים
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