Support/Social Media Connections
Social Media Connections

Connecting a WordPress site

AdaptlyPost publishes to self-hosted WordPress sites. Each post you send to a WordPress site goes out as a published blog post, with its own title, excerpt, categories, tags and featured image. Each site counts as one account on your plan.

What you need

  • A self-hosted WordPress site (the WordPress software on your own hosting) running version 5.6 or newer.
  • The site must be served over HTTPS.
  • A WordPress user that can edit posts, publish posts and upload files. In the default WordPress roles that means Author, Editor or Administrator. A Contributor or Subscriber account cannot publish, so the connection is refused.
  • Application passwords must be turned on. They are on by default since WordPress 5.6, but some security plugins and hosts turn them off.

Connect by approving AdaptlyPost on your site

This is the quickest way, and you never share a password.

  1. Open the Connectors page and pick WordPress.
  2. Enter your site address, for example example.com or example.com/blog if WordPress sits in a folder.
  3. Click Continue to WordPress. Your site's own admin opens on the page that asks whether to give AdaptlyPost access.
  4. Log in if WordPress asks you to, then approve the connection.
  5. WordPress creates an application password for AdaptlyPost and sends you back. The site now shows on the Connectors page.

If you decline on the WordPress page, nothing is saved and you can start again.

Connect with an application password

Use this when the approval page does not open, for example behind a login plugin, or when someone else manages the WordPress admin.

  1. In WordPress, go to Users > Profile and scroll to Application Passwords.
  2. Enter a name such as AdaptlyPost and click Add New Application Password.
  3. Copy the password WordPress shows. It is shown once. It is not your login password.
  4. In AdaptlyPost, open the WordPress connect window, enter the site address and click Use an application password instead.
  5. Enter your WordPress username and paste the application password, then click Connect WordPress site.

AdaptlyPost stores the application password encrypted and only uses it to publish your posts. You can revoke it at any time from the same Application Passwords section of your WordPress profile.

"Your host may be stripping the Authorization header"

AdaptlyPost sends the username and application password in the Authorization header of each request. Some hosts, mostly Apache servers running PHP through CGI or FastCGI, remove that header before WordPress sees it. WordPress then answers as if no one logged in, and AdaptlyPost tells you the site didn't receive the login details.

To fix it:

  1. Check the username and application password first. If you created the password by hand, create a new one and try again.

  2. On Apache, open the .htaccess file in the WordPress folder and add this line above the # BEGIN WordPress block:

PLAINTEXT
SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1

  • If you can't edit .htaccess, or the site runs on another server, ask your host to pass the Authorization header through to WordPress. Mention that WordPress application passwords need it.

  • Check your security or firewall plugin. Some block the WordPress REST API or application passwords for everyone who is not logged in.

    • Then connect again.

    What a WordPress post looks like

    When you pick a WordPress site in the composer, a WordPress section appears with the settings for that site.

    • Post title: leave it empty and AdaptlyPost uses the first line of your caption, cut to 100 characters. A title can be up to 300 characters.
    • Excerpt: the optional summary WordPress shows in post lists, feeds and search results, up to 1,000 characters.
    • Categories: pick from your site's categories, up to 50. Leave it empty to file the post under the site's default category.
    • Tags: up to 50, each up to 100 characters. A tag the site doesn't have yet is created when your WordPress role allows it, and skipped otherwise.
    • Body: your caption. Blank lines start new paragraphs, and bare links become clickable.
    • Images: the first image becomes the featured image. The other images follow the text.
    • Video: one video per post, placed after the text.
    • Alt text: the alt text you set on each image is sent to WordPress with the image.

    The post is published right away at the scheduled time. It does not wait as a draft on your site.

    Limits

    WhatLimit
    Text100,000 characters
    Media per post20 items
    ImagesJPEG, PNG, WebP or GIF, up to 20 MB each
    VideoOne MP4 or MOV file, up to 500 MB
    Title300 characters
    Excerpt1,000 characters
    Categories and tags50 each

    What WordPress posts don't include

    • No analytics. WordPress sites don't appear in AdaptlyPost's analytics.
    • No first comment and no replies.
    • No inbox for WordPress comments.

    When a site needs reconnecting

    If WordPress refuses the application password, for example because it was revoked or the user lost the Author role, the post fails with a message saying so and the site is marked for reconnect on the Connectors page. Connect it again with either method above.

    Disconnecting a site in AdaptlyPost deletes the application password AdaptlyPost created on your site.

    Will using a VPN affect my content reach to U.S. audiences?
    Workspace roles: Admin, Editor, Contributor and Viewer