{"id":392762,"date":"2026-10-28T15:12:32","date_gmt":"2026-10-28T15:12:32","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/aartian-groundswell-connector\/"},"modified":"2026-10-31T01:49:20","modified_gmt":"2026-10-31T01:49:20","slug":"aartian-groundswell-connector","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/aartian-groundswell-connector\/","author":23541487,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.4.3","stable_tag":"1.4.3","tested":"7.1.4","requires":"5.9","requires_php":"7.4","requires_plugins":null,"header_name":"Aartian Groundswell Connector","header_author":"Aartian Technologies","header_description":"Lets Groundswell publish articles to this site via a token-authenticated REST endpoint. Uses a custom header (and query fallback), so it works even on hosts that strip the standard Authorization header.","assets_banners_color":"fbfcfe","last_updated":"2026-10-31 01:49:20","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/aartian.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":104,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.4.2":{"tag":"1.4.2","author":"aartian","date":"2026-10-28 15:12:21","revision":3770941},"1.4.3":{"tag":"1.4.3","author":"aartian","date":"2026-10-31 01:49:20","revision":3776255}},"upgrade_notice":{"1.4.3":"<p>Updated articles now get their new picture. Your connection keeps working.<\/p>","1.4.2":"<p>Internal renames only. Your connection keeps working.<\/p>","1.4.1":"<p>Name change only.<\/p>","1.4.0":"<p>Fixes articles showing &quot;By&quot; with no author name, including ones already published.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3770941,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3770941,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256},"icon.svg":{"filename":"icon.svg","revision":3770941,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3770941,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3770941,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.4.2","1.4.3"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[569,323,529,7143,23853],"plugin_category":[],"plugin_contributors":[289235],"plugin_business_model":[],"class_list":["post-392762","plugin","type-plugin","status-publish","hentry","plugin_tags-automation","plugin_tags-blog","plugin_tags-content","plugin_tags-publishing","plugin_tags-rest-api","plugin_contributors-aartian","plugin_committers-aartian"],"banners":{"banner":"https:\/\/ps.w.org\/aartian-groundswell-connector\/assets\/banner-772x250.png?rev=3770941","banner_2x":"https:\/\/ps.w.org\/aartian-groundswell-connector\/assets\/banner-1544x500.png?rev=3770941","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/aartian-groundswell-connector\/assets\/icon.svg?rev=3770941","icon":"https:\/\/ps.w.org\/aartian-groundswell-connector\/assets\/icon.svg?rev=3770941","icon_2x":false,"generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>Groundswell writes articles for your business and publishes them to your website. This plugin gives Groundswell a safe way in:<\/p>\n\n<ul>\n<li>A private token, made on your site, that only Groundswell holds. You can make a new one at any time from Settings \u2192 Groundswell.<\/li>\n<li>It works on hosts that remove the standard login header (many budget and LiteSpeed hosts), because the token travels in its own header.<\/li>\n<li>Articles are published under a real author you choose (\"Publish as\"), with their category and featured image.<\/li>\n<li>Groundswell can update an article it published, but it can never move it to a new address.<\/li>\n<\/ul>\n\n<p>The plugin does nothing until you paste its Site URL and token into your Groundswell account.<\/p>\n\n<h3>External services<\/h3>\n\n<p>This plugin connects your site to <strong>Groundswell<\/strong>, an article writing and publishing service run by Aartian Technologies (https:\/\/app.aartian.com). It is needed so Groundswell can publish to your site.<\/p>\n\n<p>What is sent and when:<\/p>\n\n<ul>\n<li><strong>Groundswell calls your site.<\/strong> Once you have pasted the token into Groundswell, it calls this plugin's REST routes (<code>\/wp-json\/groundswell\/v1\/...<\/code>) to check the connection and to publish, update or remove the articles it wrote. Each call carries your token.<\/li>\n<li><strong>Your site answers with:<\/strong> 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.<\/li>\n<li><strong>Your site downloads pictures from Groundswell.<\/strong> 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.<\/li>\n<\/ul>\n\n<p>No visitor data is collected or sent. Nothing is sent before you connect the site in Groundswell.<\/p>\n\n<ul>\n<li>Terms of use: https:\/\/app.aartian.com\/terms<\/li>\n<li>Privacy policy: https:\/\/app.aartian.com\/privacy<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Install and activate the plugin, from Plugins \u2192 Add New or by uploading the zip.<\/li>\n<li>Go to Settings \u2192 Groundswell and copy the Site URL and the token.<\/li>\n<li>In Groundswell, connect your website and paste both values.<\/li>\n<li>Optional: under \"Publish as\", choose whose name appears on the articles. It starts as the site's first Administrator.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"whose%20name%20appears%20on%20the%20articles%3F\"><h3>Whose name appears on the articles?<\/h3><\/dt>\n<dd><p>The user chosen under Settings \u2192 Groundswell \u2192 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.<\/p><\/dd>\n<dt id=\"i%20updated%20from%20an%20older%20version.%20do%20my%20old%20articles%20still%20have%20no%20author%3F\"><h3>I updated from an older version. Do my old articles still have no author?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"how%20do%20i%20disconnect%20groundswell%3F\"><h3>How do I disconnect Groundswell?<\/h3><\/dt>\n<dd><p>Click \"Regenerate token\" on Settings \u2192 Groundswell, or deactivate the plugin. The old token stops working straight away.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.4.3<\/h4>\n\n<ul>\n<li>When Groundswell updates an article with a new picture, the new picture now becomes the featured image. Before, an update kept the old picture.<\/li>\n<li>Sending the same picture again no longer adds another copy to the Media Library.<\/li>\n<\/ul>\n\n<h4>1.4.2<\/h4>\n\n<ul>\n<li>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.<\/li>\n<\/ul>\n\n<h4>1.4.1<\/h4>\n\n<ul>\n<li>Renamed to Aartian Groundswell Connector for the WordPress.org directory. No change in behaviour.<\/li>\n<\/ul>\n\n<h4>1.4.0<\/h4>\n\n<ul>\n<li>Articles are saved under a real author: the new \"Publish as\" setting, or the first Administrator. They are no longer saved with no author.<\/li>\n<li>Articles saved with no author by older versions are given the \"Publish as\" user, once.<\/li>\n<li>The connection check and each publish now report the plugin version, and each publish reports the author name.<\/li>\n<li>Added this readme.<\/li>\n<\/ul>\n\n<h4>1.3.0<\/h4>\n\n<ul>\n<li>Groundswell can update an article it published, in place.<\/li>\n<\/ul>","raw_excerpt":"Lets the Groundswell content service publish articles to your site with a private token. It works on hosts that block WordPress app passwords.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/392762","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=392762"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/aartian"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=392762"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=392762"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=392762"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=392762"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=392762"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=392762"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}