LearnDash ConvertKit

Documentation

The LearnDash – ConvertKit plugin is designed to make communicating with LearnDash students both easier and more efficient. This is accomplished by enabling ConvertKit subscription functionality during the course enrollment process and also by tagging those students according to the courses they enroll in.

Settings

To enable automatic updates and premium support, navigate to LearnDash LMS – > Settings – > ConvertKit -> Licensing and activate your license key (which you can find on your purchase history page)

To get started using LearnDash – ConvertKit, it is first necessary to obtain an API key from within your ConvertKit account. To get this, login to your account at convertkit.com, then proceed to Account Settings. You will see an API key and API secret that you will copy and enter into the LearnDash – ConvertKit settings.

LearnDash ConvertKit API key and secret

Once you have obtained your API key from ConvertKit, login to your WordPress site where the LearnDash – ConvertKit extension is installed and navigate to LearnDash LMS – > Settings – > ConvertKit. There you will see a text field which is patiently waiting for your new API key. Paste it into that field and hit the Save Changes button.

 

After you have saved your API key, if the key is invalid, you will see an error message saying “Error in getting forms from ConvertKit. Please double check your API key and secret are valid or try again later”. Once you have a valid API key and secret entered, select a form and then hit Save Changes again. If you have left “Auto Sync Course Tags” on, then Tags will be automatically created for all Courses behind the scenes. If you have this turned off, each Course will not be created as a Tag until a user subscribes.

 

Auto Subscribe Users

If you want users to automatically be subscribed to the proper ConvertKit Form and added to Course Tags, you must enable the “Auto Subscribe” feature. When enabled, users will automatically be subscribed to your selected ConvertKit Form when enrolling in a course.

If you want users to be added without confirmation, you will need to disable the “Incentive Email”. See more information here: https://help.convertkit.com/en/articles/2502655-the-incentive-email

Please be cautious when using Auto Subscribe and/or Single Opt-In. Some countries do not allow it and you do not want to be flagged as an abuser of these features or “email farming”. You have been warned 😉

Enabling Subscription Form

If you don’t want to use the auto-subscribe feature, and would rather have users manually subscribe to each Course, then this option is what you need.

In order to enable the subscription form for a course, edit the course and check the Show Subscription Form box on the right side of the screen. If a Tag has been created for the Course, you will see some info about that Tag.

LearnDash ConvertKit Show Form metabox

 

 

Shortcode

The LearnDash – ConvertKit plugin includes a shortcode which allows a subscription button to be displayed within content anywhere on your site. To use this shortcode, enter the following within the contents of any page or post:

[ld_convertkit_subscriber_form course=”123″]

You can add this shortcode using the LearnDash shortcode tool, or by manually typing the shortcode.

Important Notes

When using the LearnDash – ConvertKit extension, there are a few important facts to remember.

The subscription form will only appear for logged in users

Visitors to your site will not see a subscription form until they login. If they do not yet have a user account they will need to register for one before seeing any ConvertKit subscription features.

ConvertKit does not always show tagged subscribers immediately

If you are testing the tag functionality or have users subscribing and login to ConvertKit to verify that the subscribers are being added to the right tag, do not be surprised if they are not there initially. Please wait at least an hour to be sure.

Changelog

1.4.0

  • Fixes an issue with the __wakeup() and __clone() method visibility
  • Updates our Licensing and Support module to the latest version
  • Updates our settings field module to the latest version

1.3.0

  • Moves the License Field to a sub-page under LearnDash LMS -> Settings -> ConvertKit -> Licensing as the LearnDash Hub Plugin (automatically installed when updating to LearnDash v4.3.0.2) removes the LMS License Tab from view

1.2.0

  • Supports logging debug data when WP_DEBUG_LOG is active
  • Prevents a possible issue when pulling all Tags from ConvertKit
  • Fixes Support Form
  • Updates our Licensing and Support module to the latest version
  • Bumps WordPress Tested To to 5.8.2
  • Adds Requires LearnDash and LearnDash Tested To data

1.1.2

  • Prevents LearnDash Content Cloner from copying over saved ConvertKit Tags
    • These will get set for the cloned Course once it is published

1.1.1

  • If Auto-Subscribe is enabled, Tags Students for the relevant Courses when they are added to a Group
  • Fixes an issue with checking whether a Student is already subscribed to the Form when the Form has a large number of subscribers

1.1.0

  • Add auto-subscribe.

1.0.0

  • First release.