Description
Groundswell writes articles for your business and publishes them to your website. This plugin gives Groundswell a safe way in:
- A private token, made on your site, that only Groundswell holds. You can make a new one at any time from Settings Groundswell.
- It works on hosts that remove the standard login header (many budget and LiteSpeed hosts), because the token travels in its own header.
- Articles are published under a real author you choose (“Publish as”), with their category and featured image.
- Groundswell can update an article it published, but it can never move it to a new address.
The plugin does nothing until you paste its Site URL and token into your Groundswell account.
External services
This plugin connects your site to Groundswell, an article writing and publishing service run by Aartian Technologies (https://app.aartian.com). It is needed so Groundswell can publish to your site.
What is sent and when:
- Groundswell calls your site. Once you have pasted the token into Groundswell, it calls this plugin’s REST routes (
/wp-json/groundswell/v1/...) to check the connection and to publish, update or remove the articles it wrote. Each call carries your token. - Your site answers with: your site name, its address, your WordPress version and this plugin’s version (connection check), plus the address, status and author name of each article it publishes.
- Your site downloads pictures from Groundswell. When an article comes with a picture, your site downloads it from the address Groundswell sends, so it can become the article’s featured image.
No visitor data is collected or sent. Nothing is sent before you connect the site in Groundswell.
- Terms of use: https://app.aartian.com/terms
- Privacy policy: https://app.aartian.com/privacy
Installation
- Install and activate the plugin, from Plugins Add New or by uploading the zip.
- Go to Settings Groundswell and copy the Site URL and the token.
- In Groundswell, connect your website and paste both values.
- Optional: under “Publish as”, choose whose name appears on the articles. It starts as the site’s first Administrator.
FAQ
-
Whose name appears on the articles?
-
The user chosen under Settings Groundswell Publish as. If that user is deleted or can no longer publish posts, the site’s first Administrator is used. To change the author of one article, edit it as usual. Groundswell will not change it back.
-
No. Versions before 1.4.0 saved articles with no author, which some themes show as “By” with nothing after it. On its first run, 1.4.0 gives those articles the “Publish as” user, once. Their dates do not change.
-
How do I disconnect Groundswell?
-
Click “Regenerate token” on Settings Groundswell, or deactivate the plugin. The old token stops working straight away.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Aartian Groundswell Connector” is open source software. The following people have contributed to this plugin.
Contributors
Translate “Aartian Groundswell Connector” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.4.3
- When Groundswell updates an article with a new picture, the new picture now becomes the featured image. Before, an update kept the old picture.
- Sending the same picture again no longer adds another copy to the Media Library.
1.4.2
- Internal names now use the prefix “aartgrco” so they cannot clash with other plugins. Your token and “Publish as” choice carry over by themselves, so connected sites keep publishing.
1.4.1
- Renamed to Aartian Groundswell Connector for the WordPress.org directory. No change in behaviour.
1.4.0
- Articles are saved under a real author: the new “Publish as” setting, or the first Administrator. They are no longer saved with no author.
- Articles saved with no author by older versions are given the “Publish as” user, once.
- The connection check and each publish now report the plugin version, and each publish reports the author name.
- Added this readme.
1.3.0
- Groundswell can update an article it published, in place.