Archiiv

Description

Beehiiv is an online newsletter subscriptions service riviling other subscriptions services like Mailchimp or Substack.

The Archiiv plugin allows site owners to easily output a simple form on the front end of their website that collects users’ emails and stores them as Beehiiv user subscribers.

The form is output via a simple shortcode placed in the text/block editor or echoed in a php template using the apply_shortcodes() function. This allows developers and site owners to output the form anywhere on the website with total control.

To connect your form with with your Beehiiv account, visit the Archiiv settings page created when you activate the plugin. You will be prompted to add your Beehiiv API key, your Beehiiv publication ID, and an optional redirect URL.

If either the API key or publication ID is missing and you use the shortcode to output your form, it will not display. Admins will see an error box that instructs them to fill out these fields in the settings page properly. Non-admins and logged out site users / vistors will not see anything. Only when the API key and publication ID are saved will the form output correctly.

If the optional redirect URL is left empty, succussful form submissions will be redirected to the homepage. We recommend setting up a specific “Thank You” page for your Beehiiv subscribers to inform them that their submission was successful, but this functionality is optional per site administrator.

Forms are output with simple CSS so that this plugin is easily accessible out-of-the-box to developers and non-developers alike. You may easily overwrite the CSS styles with your own, using another plugin, theme styles overrides, or any other preferred method of outputting custom CSS.

To target the form CSS, the following is a reference guide of classes used:
Parent Form: .beehiiv-form-connection
Email Input: .beehiiv-field-1
Submit Button: .beehiiv-submit-button

Upon successful form entry, the site admin email is sent a notification that the user is successfully subscribed. If the form entry was unsuccessful, the site admin email is also sent a notification that the request did not go through.

There are several reasons for an unsuccessful subscription, but the most likely culprit is that either the API key, publication ID, or both are incorrectly input. Instructions about where to find the Beehiiv API key and publication ID are found via a link on the Arhciiv settings page.

Installation

The Easy Way

The easiest way to intall the Archiiv plugin is to:
1. Go to your plugins menu.
2. Click “Add New”.
3. Search for “Archiiv” in the search bar.
4. Click “Install”.
5. Activate the plugin.
6. Visit the Archiiv settings page in the main admin menu.
7. Enter your Beehiiv API key and publication ID
8. Click “Save” to save your settings.
9. Use the shortcode [beehiiv_newsletter] to output the form.

The Manual Way

To upload the plugin via FTP:
1. Download the Archiiv plugin zip.
2. Unzip the plugin.
3. Using your favorite FTP client, navigate to the “plugins” directory of your WordPress Site (found in wp-content directory).
4. Upload your unzipped Archiiv folder to the “plugins” directory.
5. Activate the plugin in your plugins dashbaord in your admin panel.
6. Visit the Archiiv settings page in the main admin menu.
7. Enter your Beehiiv API key and publication ID
8. Click “Save” to save your settings.
9. Use the shortcode [beehiiv_newsletter] to output the form.

FAQ

Do I need a Beehiiv account to install this plugin?

You can install the plugin without a Beehiiv account, but it won’t output a form until you add your Beehiiv API key and plublication ID, which are both provided for you once you sign up for a paid Beehiiv account.

Can I use the free version of Beehiiv with this plugin?

No. Beehiiv does not provide API support for non-paid accounts. You can always sign up for a free Beehiiv account, but this plugin and all other integration platforms won’t work until you are able to provide an API, which is only available on paid Beehiiv accounts.

How do I uninstall the plugin? Is my data saved when it is uninstalled?

To uninstall the plugin, go to the plugins diretory in your WordPress dashboard. If it is activated, deactivate it first, then you are safe to delete the plugin. The plugin does not erase your API key, publication ID, or redirect URL when the plugin is removed. We don’t delete the data to ensure ease of access if you use our plugin again in future. If you want to ensure your data is removed from your database before unintalling the plugin, however, erase the fields in the Arhciiv settings page and click “save”.

I see and can use the form, and it is redirecting my visitors correctly, but I keep receiving an email saying the user wasn’t successfully subscribed. What does this mean?

When a user fills out the form, they will be redirected to the homepage (if your redirect URL is not set) or to your specified redirect URL, even if the subscribe request failed. This is to ensure good user expeirence on your website. Upon a failed request, site admins will receive an email notifiying them that the user was not added to their Beehiiv subscribers list, but they are still provided the email used so that the user can be added manually.

The main reasons for a form failure include either a wrong API key, publication ID, or both. You will want to check both and ensure they are correct on the backend of your Beehiiv account, which can be found here: Beehiiv Integrtions Page.

I don’t receive an email when a user fills out my form. What’s going on?

The most likely culprit is that the email is either going to spam or your hosting provider has throttled the number of emails your site is allowed to send. The way to get around this is to set up SMTP to route your email through a trusted email client. This can be done using other third-party SMTP plugins in the WordPress plugin library. Be sure to whitelist your trusted email so you can receive Archiiv’s notifications at the top of your inbox.

I don’t like the styles of the form / the styles don’t match the rest of my site. How can I override them?

We added form styles to be universal and adaptable for any web admin so that the form was styled and functional despite the level of development experience. You can change the styles and layout of the form by targeting these classes in a separate CSS sheet or plugin:
Parent Form: .beehiiv-form-connection
Email Input: .beehiiv-field-1
Submit Button: .beehiiv-submit-button

Should I contact Beehiiv if I am having trouble with this plugin?

No. Archiiv is a joint collaborative effort between Beehiiv and Arcbound, but it is still considered a third-party plugin to Beehiiv. While Beehiiv and Arcbound may promote the use of this plugin for WordPress users on their site and other resource materials, both remain largely detached from the code and therefore won’t have the answers you need to troubleshoot errors you are experiencing. For support, please post any questions you have regarding the Archiiv plguin in the plugin forum and our plugin developers will do their best to respond in a timely manner.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Archiiv” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Archiiv” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.1

  • Fixed bug not allowing forms to output correctly

1.0

  • First iteration of the plugin
  • All features have been tested for efficiency and security