Title: Shorthand Connect
Author: Shorthand
Published: October 27, 2016
Last modified: April 16, 2026
---
Search plugins
# Shorthand Connect
By [Shorthand](https://profiles.wordpress.org/shorthandconnect/)
[Download](https://downloads.wordpress.org/plugin/shorthand-connect.1.3.35.zip)
* [Details](https://test.wordpress.org/plugins/shorthand-connect/#description)
* [Reviews](https://test.wordpress.org/plugins/shorthand-connect/#reviews)
* [Installation](https://test.wordpress.org/plugins/shorthand-connect/#installation)
* [Development](https://test.wordpress.org/plugins/shorthand-connect/#developers)
[Support](https://wordpress.org/support/plugin/shorthand-connect/)
## Description
#### A new version of this plugin is now available
[Shorthand for WordPress](https://shorthand.com/products/shorthand-for-wordpress-install/index.html)
brings immersive, editorial-quality visual storytelling natively into WordPress.
Create and publish captivating Shorthand stories directly within WordPress — no
switching between tools, no separate login required.
**[Download Shorthand for WordPress](https://shorthand.com/products/shorthand-for-wordpress-install/index.html)**
Shorthand Connect will continue to work for existing stories and both plugins can
be installed simultaneously.
#### About this plugin
This plugin will allow premium Shorthand users to connect their WordPress installation
to Shorthand ([shorthand.com](https://shorthand.com)). This will allow users to
single-click publish Shorthand stories into WordPress.
### Experimental Features
1. Import media assets via cron – This feature allows your WordPress installation
to ingest Shorthand Story assets via a delayed CRON. This feature was introduced
for users with VIP Hosted sites and those who have hard timeout limits set.
### Updating
https://wordpress.org/plugins/about/svn/
### Future Directions
* A nicer feed view of the story
### HTTPS
* If you are experiencing issues related to assets being loaded via http (and your
site is using https), check your settings and ensure that the site URLs are set
to https.
### Troubleshooting
Only try these after experiencing issues
* Firstly make sure that your www directory is owned by the correct user
* In your wp-config.php file, add `define('FS_CHMOD_DIR', 0777 )`;
* Contact help@shorthand.com and ben@shorthand.com for further support and feedback
* Some WP Plugins can aggressively cache or control how content is displayed at
the theme-level; check page templates to ensure nothing is conflicting.
## Screenshots
* [[
* Coming soon
## Installation
1. Install the search for the plugin and install it within wp-admin.
2. * Or alternately upload `shorthand_connect` to the `/wp-content/plugins/` directory.
3. Activate the plugin through the ‘Plugins’ menu in WordPress.
4. Go to Settings -> Shorthand to add your Shorthand API Token retrieved in the next
step.
5. Get your API token from Shorthand.com: (Only Admin/Owners will have access to
generate API Tokens)
6. * Open the workspace settings; either by clicking your organisation name from
the dashboard OR from the top right menu when editing a story.
* Under the sub-heading API Tokens generate either a Team Token or Workspace
Token.
- A Team Token only has access to published/prepared stories under the associated
team.
- A Workspace Token has access to all published/prepared stories.
7. Optionally change the CSS settings in the options to best present stories within
your theme.
8. Optionally your theme can override the display of Shorthand stories via `single-
shorthand_story.php` in your theme directory.
9. Optionally apply post-processing in the form of regex queries; within Settings,
Post-Processing.
```
{
"head":
[
{
"query": "/(.*?)<\\/title>/",
"replace":""
},
{
"query": "/regex string/",
"replace":"String to replace it"
},
...
],
"body":[]
}
```
## FAQ
* If you have any questions, please contact help@shorthand.com
## Reviews
### [It does what it has to do](https://wordpress.org/support/topic/it-does-what-it-has-to-do/)
[raba97](https://profiles.wordpress.org/raba97/) December 6, 2017
Include easily a Shorthand Story to wordpress. It could have more customization
options, but it does the job. Keep in mind, the plugin will download the content
of the story to your wordpress, so if you don’t have enough memory, wordpress will
crash while trying to update/publish the story
### [Basic functionality, unusable in practical terms](https://wordpress.org/support/topic/basic-functionality-unusable-in-practical-terms/)
[Adrian Toll](https://profiles.wordpress.org/adriantoll/) January 17, 2017 1 reply
In theory this would be a great plugin for letting clients drop their Shorthand
stories into their own websites rather than manually uploading the files to the
server. However, there are a number of problems with the plugin that make it basically
unusable in its current form. The main one is that the default template for a Shorthand
story includes get_header() and get_footer(), and drops the Shorthand story in using
the_content(). This means that what should be a full-width design is actually crammed
into the content area of a default template, however wide that is. The plugin seems
to assume that get_header() and get_footer() don’t include content wrapping tags,
but that’s not a helpful assumption. The plugin also drops the entirety of its HTML
code into the_content() including the <title> tag and <meta> tags such as viewport,
Open Graph, Twitter and charset. That’s a strange decision given that the body tag
isn’t written out in that code. Either you assume that the body tag hasn’t been
written and include the meta tags, or you write the body tag yourself. This wouldn’t
matter so much if you were able to override the default template by using a single-
shorthand_story.php template file in your theme, but this doesn’t override the template
provided by the plugin, so your choice is to edit the plugin files – which would
get overwritten by any updates – or use the default template. Finally, even if you
do edit the template file in the plugin just to drop in the Shorthand content, the
content doesn’t render correctly for some reason – there are missing slides which
seem to be overlaid by other ones. It also tries to load non-existent web fonts
from the shorthand directory, meaning that the fonts aren’t rendered correctly.
Perhaps there are ways around this, but that’s difficult to tell because Shorthand
haven’t seen fit to write any documentation on how to use the plugin here in the
plugin directory and just direct you to their support email addresses, which isn’t
acceptable for basic usage instructions. Two stars for something that does sort
of work, with an easy-to-set-up API connection, but this needs significant improvement,
including basic documentation, before it’s usable.
[ Read all 2 reviews ](https://wordpress.org/support/plugin/shorthand-connect/reviews/)
## Contributors & Developers
“Shorthand Connect” is open source software. The following people have contributed
to this plugin.
Contributors
* [ Shorthand ](https://profiles.wordpress.org/shorthandconnect/)
[Translate “Shorthand Connect” into your language.](https://translate.wordpress.org/projects/wp-plugins/shorthand-connect)
### Interested in development?
[Browse the code](https://plugins.trac.wordpress.org/browser/shorthand-connect/),
check out the [SVN repository](https://plugins.svn.wordpress.org/shorthand-connect/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/shorthand-connect/)
by [RSS](https://plugins.trac.wordpress.org/log/shorthand-connect/?limit=100&mode=stop_on_copy&format=rss).
## Changelog
#### 1.3.35
* Fix story asset URL generation for multisite and custom upload paths by deriving
public URLs from the resolved story path.
* Pass the resolved story path through both publish flows so rewritten story asset
URLs match custom storage locations.
* Updated latest tested version to WordPress 6.9.4.
#### 1.3.34
* Scope Shorthand options CSS to admin settings pages only to prevent front-end
style bleed.
* Rename the admin styles function to comply with php:S100 naming convention.
* Added a default cover image if one is unavailable on signedCover and removed ‘
Story Version: 2’ from the story list.
#### 1.3.33
* Updated latest version to WordPress 6.7.2
#### 1.3.32
* Implemented first time setup wizard
* General fixes for UX & UI
* General Bug Fixes
* Added Shorthand Story Sorting
#### 1.3.31
* API Fixes
* Fixes to sanitisation handlers
* Method for story file uploads for WPVIP updated
#### 1.3.30b
* Swapped connect server to use sh_v2_api_post_json & sh_v2_api_post
#### 1.3.30
* Security Fixes & Updates
* JSON Post-Processing Fixes
* Further updates to meet WPVIP Standards
#### 1.3.29
* Security Fixes & Updates
* JSON Post-Processing Fixes
#### 1.3.28
* Code clean up & bug fixes
* Remove legacy API code
* Introduce a ‘Disable Advanced Custom Fields’ option under Experimental Features
#### 1.3.27
* Added Mass Publishing Feature
#### 1.3.26
* Restyled and repositioned “Update Shorthand Story” button for better clarity.
#### 1.3.25
* Fixed global variable error causing Cron failure
* Added button to update story from Shorthand
#### 1.3.24
* Media-only fetch will now strictly fetch only media to remove potential over-
write errors upon extraction.
#### 1.3.23
* Add extra debug option to execute media-only fetch.
* Fixed error display on Cron failure.
#### 1.3.22
* Add experimental option to offload media asset fetch to cron job.
* Add experimental option to enable a series of debugging tests (buttons on new
story form).
* By default the `no_update` field is set to true after the initial save.
#### 1.3.21
* Refactored the zip extraction code. Added hooks to story copy flow.
#### 1.3.20
* Restored flush_rewrite_rules() to shorthand_options.php that was lost in a previous
update.
#### 1.3.19
* Mis-fire release for 1.3.20
#### 1.3.18
* Restored previous WP file_get_contents fetch for VIP-hosted customers
#### 1.3.17
* Added alternate method of story ZIP extraction for WP VIP-hosted customers.
#### 1.3.16
* Removed references to v1 API (has been deprecated for 12+ months) and updated
filesystem calls to be WP-specific.
#### 1.3.15
* Fixed incorrect trunk copy in previous release.
#### 1.3.14
* Added story-specific error tracking and targeted updates for those using WP VIP
Hosting.
#### 1.3.13
* Bumping versions
#### 1.3.12
* Bumping versions
#### 1.3.11
* Added Post-processing Regex JSON for stripping/modifying head and body content
of Shorthand Stories. Also added custom field “no_update”; if true, updating
the WordPress Shorthand Story won’t fetch and replace the existing content.
#### 1.3.10
* Updated Installation instructions (Documentation only)
#### 1.3.9
* Updated Contact emails
#### 1.3.8
* Updated Signed URLs for thumbnails
#### 1.3.7
* Updates to internal php and API handling
#### 1.3.6
* Better sanitize input
#### 1.3.2
* Add support for hashed themes
#### 1.2.1
* Add the ability to remove abstract from post (useful for wordpress as a backend)
#### 1.2.0
* Support for WordPress v5
* Clean up settings
* Remove cURL
#### 1.1.8
* Update stable tag
#### 1.1.7
* Update testing information
* Default to v2 in new install settings
* Fix a bug where v1 stories were not identified correctly
#### 1.1.6
* Better support for switching between v1 and v2 of the API
#### 1.1.5
* Support for the latest release of Shorthand 2.0
#### 1.1.4
* Support author and custom-field in post type
#### 1.1.3
* Enable Shorthand version selection
#### 1.1.2
* Fix release issues
#### 1.1.1
* Plugin release for version 2.0 support
#### 1.1.0
* Support for Shorthand 2.0
#### 1.0.7
* Bump version number
#### 1.0.6
* Don’t show all stories on update story
* Allow single-shorthand_story.php to be overwritten
* Put meta-data in the correct location (inside the head)
#### 1.0.5
* Add stable tag.
#### 1.0.4
* Add support for post feature image (thumbnail).
#### 1.0.3
* Update description.
#### 1.0.2
* Change author and instructions.
#### 1.0.1
* Sanitize form inputs.
#### 1.0
* First release.
## Meta
* Version **1.3.35**
* Last updated **4 weeks ago**
* Active installations **100+**
* WordPress version ** 6.0 or higher **
* Tested up to **6.9.4**
* PHP version ** 7.0 or higher **
* Language
* [English (US)](https://wordpress.org/plugins/shorthand-connect/)
* Tags
* [api](https://test.wordpress.org/plugins/tags/api/)[editor](https://test.wordpress.org/plugins/tags/editor/)
[reports](https://test.wordpress.org/plugins/tags/reports/)[storytelling](https://test.wordpress.org/plugins/tags/storytelling/)
* [Advanced View](https://test.wordpress.org/plugins/shorthand-connect/advanced/)
## Ratings
3.5 out of 5 stars.
* [ 1 5-star review ](https://wordpress.org/support/plugin/shorthand-connect/reviews/?filter=5)
* [ 0 4-star reviews ](https://wordpress.org/support/plugin/shorthand-connect/reviews/?filter=4)
* [ 0 3-star reviews ](https://wordpress.org/support/plugin/shorthand-connect/reviews/?filter=3)
* [ 1 2-star review ](https://wordpress.org/support/plugin/shorthand-connect/reviews/?filter=2)
* [ 0 1-star reviews ](https://wordpress.org/support/plugin/shorthand-connect/reviews/?filter=1)
[Your review](https://wordpress.org/support/plugin/shorthand-connect/reviews/#new-post)
[See all reviews](https://wordpress.org/support/plugin/shorthand-connect/reviews/)
## Contributors
* [ Shorthand ](https://profiles.wordpress.org/shorthandconnect/)
## Support
Got something to say? Need help?
[View support forum](https://wordpress.org/support/plugin/shorthand-connect/)