/
readme.txt
86 lines (52 loc) · 4.06 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
=== Mailcoach ===
Contributors: nielsvanp
Donate link: https://github.com/sponsors/spatie
Tags: mail, mass mailing, spatie, mailcoach, developer
Requires PHP: 8.1
Requires at least: 8.1
Tested up to: 6.2
Stable tag: 0.0.12
License: MIT
Embed forms easily on your WordPress site with this plugin. Use shortcodes to add them to specific pages, creating a seamless user experience.
== Description ==
Mailcoach is an email marketing platform that covers all your email needs for a fraction of the cost. Don't pay for subscribers, pay for what you send.
## Introduction
[Mailcoach](https://mailcoach.app) is both a self-hosted and hosted email marketing platform that integrates with services like Amazon SES, Mailgun, Postmark or Sendgrid to send out bulk mailings and drip campaigns affordably. It can also keep track of all transactional mails sent out by your app.
Cloud, stand-alone, or integrated in a project, it's the perfect email list service for bloggers, artisans and entrepreneurs.
This plugin allows admins to create a subscribe form to a mailcoach email list. This can be plugged into your website with a shortcode.
## Installation
To install the Mailcoach plugin, follow these steps:
1. Go to your WordPress site and navigate to the "Plugins" section.
2. Click on the "Add New" button.
3. Search for "Mailcoach" and click on the plugin.
4. Click "Activate" to enable the plugin.
5. You will now be able to see Mailcoach in your Admin navigation.
Alternatively, you can download the plugin directly from the WordPress plugin store at https://wordpress.org/plugins/forms-mailcoach/.
## Using Mailcoach
### Setting up your credentials
Before we can proceed, you'll need an API Token and the Mailcoach URL, which can be obtained from your Mailcoach profile settings.
1. Log in to your Mailcoach instance and access your Mailcoach profile settings.
2. Create a new API Token.
3. In your WordPress Admin panel, navigate to Mailcoach settings and enter the API Token and Mailcoach URL.
4. Save the settings.
5. You should be able to view all your email lists with the number of subscribers. If no lists are displayed, make sure you create a list on your Mailcoach instance first.
### Creating a form
Now let's move on to the core functionality of the plugin. Navigate to the "Forms" or "Add Form" section in the WordPress Admin panel.
You can easily design and customize a form with your own HTML to seamlessly integrate with your website's look and feel.
You may encounter a warning regarding the "Email List" with the message "External form subscriptions are not enabled for this list. Please enable them in the Mailcoach dashboard."
To enable external form subscriptions, go to the email list settings on your Mailcoach instance.
Access the "Onboarding" tab and enable the option "Allow POST from an external form." Don't forget to save.
After saving the form, you will notice a shortcode field that cannot be updated. Copy the shortcode for later use.
You also have the option to customize the messages displayed to the user after they attempt to subscribe.
### Embed a form on your page
Displaying your subscription form on specific pages is a breeze.
1. Navigate to the desired page where you want to showcase the form.
2. Paste the shortcode at the desired location on the page.
3. Ensure that the shortcode is enclosed within [brackets].
4. After inserting the shortcode, preview the page to verify the form's functionality. Please note that Cloudflare 5. turnstile provides spam protection for your forms.
