From d67d260d049dbb0b5d5359f92675cad136b248b1 Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Wed, 22 Nov 2023 10:55:13 +0000 Subject: [PATCH 01/46] Fix email.rst & remove Symfony Mailer - in config --- docs/channels/emails.rst | 111 +-------------------------------------- 1 file changed, 2 insertions(+), 109 deletions(-) diff --git a/docs/channels/emails.rst b/docs/channels/emails.rst index d1f33b1e..fd9cc8c8 100644 --- a/docs/channels/emails.rst +++ b/docs/channels/emails.rst @@ -19,7 +19,7 @@ Template Emails .. vale on -Template Emails are transactional by default. They're used in Campaigns, Form submit actions, Point triggers, etc. It's possible to send template Emails to the same Contact multiple times. You can't send template Emails to a Contact outside of another Mautic Component except when sending an Email directly to a Contact - in this case Mautic clones the content. +Template Emails are transactional by default. They're used in Campaigns, Form submit actions, Point Triggers, etc. It's possible to send template Emails to the same Contact multiple times. You can't send template Emails to a Contact outside of another Mautic Component except when sending an Email directly to a Contact - in this case Mautic clones the content. .. note:: For this reason, template Emails sent directly to a Contact aren't associated with the template Email itself and thus stats aren't tracked against it. @@ -222,113 +222,6 @@ Using the Email signature Marketers can place the signature into an Email using the ``{signature}`` token. -Email delivery -############## - -As Mautic uses the :xref:`Symfony Mailer` library since v5, it supports all Symfony Mailer core plugins out of the box. Transports for other Email services might be found on GitHub or Packagist. - -SMTP transport -************** - -The SMTP transport is the default transport used for sending Emails with Mautic. It's configured in the Mautic configuration under the Email Settings tab. The configuration is the same as in the :xref:`Symfony Mailer` documentation. - -Mautic now uses a specific way of providing the connection details for Email transports to interpret, which is called a Data Source Name, or DSN. This is the example Data Source Name configuration mentioned in the :xref:`Symfony Mailer` documentation for SMTP: - -.. code-block:: shell - - smtp://user:pass@smtp.example.com:port - -Mautic creates this automatically from the values entered in the Email configuration: - -.. image:: images/emails/smtp-dsn.png - :width: 400 - :alt: SMTP API DSN example - -.. list-table:: Example DSN ``smtp://user:pass@smtp.example.com:port/path?option1=value1&option2=value2`` explained - :widths: 10 20 150 - :header-rows: 1 - :stub-columns: 1 - - * - DSN part - - Example - - Explanation - * - Scheme - - smtp - - Defines which email transport (plugin) will handle the email sending. It also defines which other DSN parts must be present. - * - User - - john - - Some transport wants username and password to authenticate the connection. Some public or private key. Some just API key. - * - Password - - pa$$word - - As mentioned above, read documentation for your particular transport and fill in the fields that are required. For SMPT this is for password. - * - Host - - smtp.mydomain.com - - For SMTP this is the domain name where your SMTP server is running. Other transports may have the domain handled inside it so many wants to put just ``default`` text here. - * - Path - - any/path - - This is usually empty. For SMTP this may be the path to the SMTP server. For other transports this may be the path to the API endpoint. - * - Port - - 465 - - Important for SMTP. The port value defines which encryption is used. This is usually 465 for SSL or 587 for TLS. Avoid using port 25 for security reasons. For other transports this may be the port to the API endpoint. - * - Options - - timeout=10 - - This is optional. This may be the timeout for the connection or similar configuration. The config form will allow you to create multiple options. - -.. note:: - Use the Mautic's global configuration to paste in the DSN information, especially the API keys and passwords. The values must be URL-encoded, and the configuration form does that for you. If you are pasting DSN settings directly into the config/local.php file, you must URL-encode the values yourself. - - -.. vale off - -Example API transport installation - -.. vale on - -********************************** -.. warning:: - Installing Symfony Transports is possible when you've :doc:`installed Mautic via Composer `. - -If you want to use :xref:`Sendgrid` API instead of SMTP to send Emails, for example, you can install the official Symfony Sendgrid Transport by running the following command that is mentioned along others in the :xref:`Symfony Mailer` documentation. - -.. code-block:: shell - - composer require symfony/sendgrid-mailer - -After that, you can configure the transport in the Mautic configuration. The example DSN is again mentioned in the :xref:`Symfony Mailer` documentation along with other transports. In the example of using the Sendgrid API, the DSN looks like this: - -.. code-block:: shell - - sendgrid+api://KEY@default - -This is how it would be set up in Mautic's Email configuration: - - .. image:: images/emails/sendgrid-api-dsn.png - :width: 400 - :alt: Sendgrid API DSN example - -To replace the Sendgrid API key, add it to the relevant field in the Email configuration and save. Mautic now uses the Sendgrid API to send Emails. - -.. warning:: - It's a nice perk that Mautic can use any transport provided by Symfony Mailer. However, be aware that such transports (from Symfony) don't support batch sending, even via API. They only send one email per request, as opposed to a thousand emails per request as is the case with some Mautic transports, which can make them slow at scale. They also don't support transport callback handling used for bounce management. If you plan to send larger volumes of Emails or need to use features which require callback handling, please consider using Email transports built specifically for such use. These plugins are available in the :doc:`Mautic Marketplace `. - -The system can either send Emails immediately or queue them for processing in batches by a :doc:`cron job `. - -Immediate delivery -****************** - -This is the default means of delivery. As soon as an action in Mautic triggers an Email to send, it's sent immediately. If you expect to send a large number of Emails, you should use the queue. Sending Email immediately may slow the response time of Mautic if using a remote mail service, since Mautic has to establish a connection with that service before sending the mail. Also attempting to send large batches of Emails at once may hit your server's resource limits or Email sending limits if on a shared host. - -Queued delivery -*************** - -Mautic works most effectively with high send volumes if you use the queued delivery method. Mautic stores the Email in the configured spool directory until the execution of the command to process the queue. Set up a :doc:`cron job ` at the desired interval to run the command: - -.. code-block:: shell - - php /path/to/mautic/bin/console messenger:consume email_transport - -Some hosts may have limits on the number of Emails sent during a specified time frame and/or limit the execution time of a script. If that's the case for you, or if you just want to moderate batch processing, you can configure batch numbers and time limits in Mautic's Configuration. See the :doc:`cron job documentation ` for more specifics. - .. vale off Tracking Opened Emails @@ -418,7 +311,7 @@ If you select an Unsubscribe folder, Mautic also appends the Email as part of th Webhook bounce management ************************* -Since Mautic 5 all the Email transports use the same Webhook (sometimes called callback) URL: ``https://mautic.example.com/mailer/callback``. Please follow the documentation for the specific Email transport you've installed to get more information about the Webhook configuration. +Since Mautic 5 all the Email transports use the same Webhook - sometimes called callback - URL: ``https://mautic.example.com/mailer/callback``. Please follow the documentation for the specific Email transport you've installed to get more information about the Webhook configuration. .. vale off From f08961b1f0ccc7e184563fa10b276a089c395372 Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Wed, 22 Nov 2023 12:01:28 +0000 Subject: [PATCH 02/46] Vale fixes for Settings --- .github/styles/Vocab/Mautic/accept.txt | 3 + docs/configuration/settings.rst | 114 ++++++++++++++----------- docs/links/esp_sendgrid.py | 4 +- docs/links/mautic_sparkpost_plugin.py | 7 ++ 4 files changed, 78 insertions(+), 50 deletions(-) create mode 100644 docs/links/mautic_sparkpost_plugin.py diff --git a/.github/styles/Vocab/Mautic/accept.txt b/.github/styles/Vocab/Mautic/accept.txt index d0badad2..5b0922fc 100644 --- a/.github/styles/Vocab/Mautic/accept.txt +++ b/.github/styles/Vocab/Mautic/accept.txt @@ -33,6 +33,7 @@ DDEV Do Not Contact DNC Dripflow +DSN Dynamic Web Content FALSE Focus Item @@ -55,6 +56,7 @@ https HubSpot IDP IMAP +IPs infographics JavaScript Joomla @@ -105,6 +107,7 @@ sublicense SugarCRM Suhosin Symfony +TLS Todo Transifex TRUE diff --git a/docs/configuration/settings.rst b/docs/configuration/settings.rst index f86ea2d1..686dba29 100644 --- a/docs/configuration/settings.rst +++ b/docs/configuration/settings.rst @@ -20,10 +20,10 @@ General settings To brand that Landing Page, create a Mautic Landing Page that you'd want to greet any Contacts who visit your root ``URL``. Once you've done that, Users can sign in into Mautic by visiting ``mautic.example.com/s/login``. -* **404 page** - Select the Landing Page that you want to use as the 404 Landing Page. If you don't want to use Mautic's default 404 error page, create a custom Landing Page and select that page here. If you don't select any page, Mautic uses the default error page. +* **404 page** - Select the Landing Page that you want to use as the 404 Landing Page. If you don't want to use Mautic's default 404 error page, create a custom Landing Page and select that Landing Page here. If you don't select any page, Mautic uses the default error page. -* **Path to the cache, log, and images directory** - These are the file system paths where the cache, logs, and images are saved. +* **Path to the cache, log, and images directory** - These are the file system paths where Mautic saves the cache, logs, and images. System defaults =============== @@ -34,9 +34,9 @@ System defaults * **Default item limit per page** - The number of Contacts, Campaigns, Emails, etc. which display on each page when you go to an item section. The default is ``10``. -* **Default timezone** - The User's default time zone, typically set to the time zone of the Company headquarters. Time zones are set for individual Users. The default is ``UTC``. +* **Default timezone** - The User's default time zone, typically set to the time zone of the Company headquarters. Mautic allows the User to set their own time zones via their profile. The default is ``UTC``. - For example: headquarters is in Boston and the default is set to ``US`` Eastern Time ``America/New York``. A User in San Francisco US Pacific Time may set ``America/Los Angeles`` to use Pacific Time in the User interface. + For example: headquarters is in Boston and Mautic's timezone is ``America/New York``. A User in San Francisco which is Pacific Time may set ``America/Los Angeles`` to use Pacific Time in the User interface. * **Default language** - The initial language assigned to Users. Individual Users may select their own settings. Mautic uses ``English - United States`` by default. @@ -44,20 +44,20 @@ System defaults * **Date Range Filter Default** - Sets the default for how far back from the current date Mautic looks for data in Reports including Campaign and Email snapshots charts on the item page. This setting allows you to control the default for how far back from the current date Mautic looks for data. If you've changed the setting on a Report, Mautic uses what you've entered. Mautic's default value is ``1 Month``. -* **Default format for full dates, date only, short dates, and time only** - The default setting uses the standard US time format. The letters in the boxes are PHP code. See the :xref:`PHP manual for date functions`. +* **Default format for full dates, date only, short dates, and time only** - The default setting uses the standard American time format. The letters in the boxes are PHP code. See the :xref:`PHP manual for date functions`. CORS settings ============= -Cross-Origin Resource Sharing (CORS) enables data to pass between your website and Mautic. +Cross-Origin Resource Sharing - CORS - allows data to pass between your website and Mautic. .. image:: images/cors-settings.png :width: 600 :alt: Screenshot showing CORS Settings Configuration in Mautic -* **Restrict Domains** - When set to No, any web page can pass information to Mautic. Select Yes to limit communication with your Mautic instance to websites listed in Valid Domains strongly recommended. +* **Restrict Domains** - When set to No, any website can pass information to Mautic. Selecting ``Yes`` to limit communication with your Mautic instance to websites listed in Valid Domains is **strongly recommended**. -* **Valid Domains** - A list of domains allowed to communicate with your Mautic instance. In the text box, list the exact URL of the top level domain you want to allow, one per line. For example: ``http://www.example.com`` tracks any activity on non-secure example.com pages, but ``https://www.example.com`` won't because this is only tracking on a secure (``https://``) website. +* **Valid Domains** - A list of domains allowed to communicate with your Mautic instance. In the text box, list the exact URL of the top level domain you want to allow, one per line. For example: ``http://www.example.com`` tracks any activity on non-secure example.com pages, but ``https://www.example.com`` won't because this is only tracking on a secure ``https://`` website. .. note:: @@ -72,25 +72,25 @@ Miscellaneous settings * **Trusted hosts** - To explicitly allow the hosts that can send requests to Mautic. You can use regular expression and separate multiple hosts with a comma. i.e ``.*\.?example.com$``. If left empty, Mautic will respond to all hosts. -* **Trusted proxies** - To configure the IP addresses that should be trusted as proxies. This setting is mandatory when using Mautic behind an SSL terminating proxy. Separate multiple IP addresses by a comma. i.e ``127.0.0.1, 10.0.0.0/8, fc00::/7`` +* **Trusted proxies** - To configure the IP addresses that Mautic should trust as proxies. This setting is mandatory when using Mautic behind an SSL terminating proxy. Separate multiple IP addresses by a comma. i.e ``127.0.0.1, 10.0.0.0/8, fc00::/7`` -* **IP lookup service** - By default, Mautic uses :xref:`MaxMind's` database to identify the city of a website visitor, based on the location of the Internet Service Provider (ISP) for their IP address. +* **IP lookup service** - By default, Mautic uses :xref:`MaxMind's` database to identify the city of a website visitor, based on the location of the Internet Service Provider - ISP - for their IP address. * **IP lookup service authentication** - To use any IP lookup service which requires authentication, enter your credentials. -* **List of IPs not to track Contacts with** - To turn off tracking for particular IP addresses, enter the addresses, one per line. Mautic doesn't recommend adding your office IP address. If you list your internal IP address, Mautic won't track clicks, page hits, etc., from that IP, **including when you are testing functionality**. +* **List of IPs not to track Contacts with** - To turn off tracking for particular IP addresses, enter the addresses, one per line. Mautic doesn't recommend adding your office IP address. If you list your internal IP address, Mautic won't track clicks, page hits, etc., from that IP, **including when you are testing** which can cause difficulties. -* **List of known Bots** - Mautic has the feature to identify and turn-off tracking for several known bots. To track activity from those bots, remove them from this list. To turn off tracking for other bots, add them here (one per line). +* **List of known Bots** - Mautic has the feature to identify and turn-off tracking for several known bots. To track activity from those bots, remove them from this list. To turn off tracking for other bots, add them here - one per line. * **URL Shortener** - If you use a URL shortening service like bit.ly for links in SMS messages, enter your access token here. .. note:: - For bit.ly, use the following URL structure: https://api-ssl.bitly.com/v3/shorten?access_token=[ACCESS_TOKEN]&format=txt&longUrl + For bit.ly, use the following URL structure: ``https://api-ssl.bitly.com/v3/shorten?access_token=[ACCESS_TOKEN]&format=txt&longUrl`` * **Item max lock time** - When a User edits a Campaign, Email, Landing Page, etc., Mautic locks the item to prevent simultaneous edits by other Users. When the initial User saves and closes or cancels out, the item may remain locked for this period of time. The default is ``0 seconds``. -* **Translate page titles** - To translate page titles in the Contact activity history from non-Latin (non-English) characters to Latin characters (English). +* **Translate page titles** - To translate page titles in the Contact activity history from non-Latin characters to Latin - English - characters. Update settings @@ -102,7 +102,7 @@ Update settings * **Set the minimum stability level required for updates** - This allows you to receive notifications for early access releases. Always read the release notes before updating to an early access release. Set the minimum stability level required for updates. -* **Update Mautic through Composer [BETA]** - Set to 'Yes' if you update Mautic through Composer. This is a prerequisite if you want to install and update Plugins through the Marketplace. This becomes the default installation and update method in Mautic 5. +* **Update Mautic through Composer [beta]** - Set to 'Yes' if you update Mautic through Composer. This is a prerequisite if you want to install and update Plugins through the Marketplace. This becomes the default installation and update method in Mautic 5. Theme settings ************** @@ -126,7 +126,7 @@ Full API documentation is available :xref:`Mautic developer API`. * **Enable http basic auth?** - Enables basic authentication for Mautic's API. It's recommended to only use this with secure sites (https). -* **Access token lifetime** - When authorizing a new app or Integration, this setting limits how long the access token is valid (in minutes). The default is ``60`` minutes. +* **Access token lifetime** - When authorizing a new app or Integration, this setting limits how long the access token is valid - in minutes. The default is ``60`` minutes. For example - You add a new Integration to your SaaS platform. Enter 30 here to limit the access token validity to ``30`` minutes. If you haven't completed the authentication in that period of time, you must revalidate. @@ -154,9 +154,9 @@ Campaign settings * **Wait time before retrying a failed action** - If for any reason a Campaign action doesn't execute, this is the length of time Mautic waits before trying again. -* **Use date range for all views** - When viewing a Campaign, the date range of actions, conditions, decisions, and Contacts displayed in the tabs is based on this setting. +* **Use date range for all views** - When viewing a Campaign, the date range of actions, conditions, decisions, and Contacts displayed in the tabs, Mautic uses this date range by default. -* **Use summary statistics** - Improves performance when viewing a Campaign with thousands of events per day by using summarized data. When you first turn on this setting you will need to run a :ref:`cron job` to summarize existing data. +* **Use summary statistics** - Improves performance when viewing a Campaign with thousands of events per day by using summarized data. When you first turn on this setting you need to run a :ref:`cron job` to summarize existing data. Email settings ************** @@ -164,7 +164,7 @@ Email settings Email transport settings ======================== -As Mautic uses the :xref:`Symfony Mailer` library since v5, it supports all Symfony Mailer core plugins out of the box. Transports for other Email services might be found on GitHub or Packagist. +As Mautic uses the :xref:`Symfony Mailer` library since v5, it supports all Symfony Mailer core Plugins out of the box. SMTP transport -------------- @@ -192,29 +192,29 @@ Mautic creates this automatically from the values entered in the Email configura - Example - Explanation * - Scheme - - smtp - - Defines which email transport (plugin) will handle the email sending. It also defines which other DSN parts must be present. + - ``smtp`` + - Defines which transport Plugin handles the Email sending. It also defines which other DSN parts must be present. * - User - - john + - ``john`` - Some transport wants username and password to authenticate the connection. Some public or private key. Some just API key. * - Password - - pa$$word - - As mentioned above, read documentation for your particular transport and fill in the fields that are required. For SMPT this is for password. + - ``pa$$word`` + - As mentioned previously, read the documentation for your particular transport and fill in the fields it requires. For SMTP enter the password in this field. * - Host - - smtp.mydomain.com - - For SMTP this is the domain name where your SMTP server is running. Other transports may have the domain handled inside it so many wants to put just ``default`` text here. + - ``smtp.mydomain.com`` + - For SMTP, this is the domain name where your SMTP server is running. Other transports may have the domain handled within the Plugin, so they may instruct you to enter ``default`` here. * - Path - - any/path - - This is usually empty. For SMTP this may be the path to the SMTP server. For other transports this may be the path to the API endpoint. + - ``example/path`` + - This is usually empty. For SMTP this may be the path to the SMTP server. For other transports this may be the path to the API endpoint. Enter according to the documentation for your transport. * - Port - - 465 - - Important for SMTP. The port value defines which encryption is used. This is usually 465 for SSL or 587 for TLS. Avoid using port 25 for security reasons. For other transports this may be the port to the API endpoint. + - ``465`` + - Important for SMTP. The port value defines the encryption used. This is usually ``465`` for SSL or ``587`` for TLS. Avoid using port 25 for security reasons. For other transports this may be the port to the API endpoint. * - Options - - timeout=10 - - This is optional. This may be the timeout for the connection or similar configuration. The config form will allow you to create multiple options. + - ``timeout=10`` + - This is optional. This may be the timeout for the connection or similar configuration. The configuration allows you to create multiple options. .. note:: - Use the Mautic's global configuration to paste in the DSN information, especially the API keys and passwords. The values must be URL-encoded, and the configuration form does that for you. If you are pasting DSN settings directly into the config/local.php file, you must URL-encode the values yourself. + Use Mautic's global configuration to paste in the DSN information, especially the API keys and passwords. The values must be URL-encoded, and the configuration form does that for you. If you are pasting DSN settings directly into the ``config/local.php`` file, you must URL-encode the values yourself. .. vale off @@ -227,30 +227,44 @@ Example API transport installation .. warning:: Installing Symfony Transports is possible when you've :doc:`installed Mautic via Composer `. -If you want to use :xref:`Sendgrid` API instead of SMTP to send Emails, for example, you can install the official Symfony Sendgrid Transport by running the following command that is mentioned along others in the :xref:`Symfony Mailer` documentation. +If you want to use :xref:`SendGrid` API instead of SMTP to send Emails, for example, you can install the official Symfony SendGrid Transport by running the following command mentioned alongside others in the :xref:`Symfony Mailer` documentation. .. code-block:: shell composer require symfony/sendgrid-mailer -After that, you can configure the transport in the Mautic configuration. The example DSN is again mentioned in the :xref:`Symfony Mailer` documentation along with other transports. In the example of using the Sendgrid API, the DSN looks like this: +After that, you can configure the transport in the Mautic configuration. The example DSN is again mentioned in the :xref:`Symfony Mailer` documentation along with other transports. In the example of using the SendGrid API, the DSN looks like this: .. code-block:: shell sendgrid+api://KEY@default -This is how it would be set up in Mautic's Email configuration: +This is how you would configure Mautic's Email configuration: .. image:: images/sendgrid-api-dsn.png :width: 400 - :alt: Sendgrid API DSN example + :alt: SendGrid API DSN example To replace the SendGrid API key, add it to the relevant field in the Email configuration and save. Mautic now uses the SendGrid API to send Emails. .. warning:: - It's a nice perk that Mautic can use any transport provided by Symfony Mailer. However, be aware that such transports (from Symfony) don't support batch sending, even via API. They only send one email per request, as opposed to a thousand emails per request as is the case with some Mautic transports, which can make them slow at scale. They also don't support transport callback handling used for bounce management. If you plan to send larger volumes of Emails or need to use features which require callback handling, please consider using Email transports built specifically for such use. These plugins are available in the :doc:`Mautic Marketplace `. + It's a nice perk that Mautic can use any transport provided by Symfony Mailer. However, be aware that such transports from Symfony **don't support batch sending, even via API**. They only send one Email per request, as opposed to a thousand Emails per request as is the case with some Mautic transports, which can make them slow at scale. They also **don't support transport callback handling used for bounce management**. If you plan to send larger volumes of Emails or need to use features which require callback handling, please consider using Email transports built specifically for such use. These Plugins are available in the :doc:`Mautic Marketplace `. -The system can either send Emails immediately or queue them for processing in batches by a :doc:`cron job `. +The table below lists available transport Plugins created for Mautic to include support for batch sending and callback handling. + +.. list-table:: + :widths: 40 60 + :header-rows: 1 + + * - Link to Packagist + - Command for installing + * - :xref:`sparkpost-transport` + - ``composer require ts-navghane/sparkpost-plugin`` + +Queue settings +============== + +The system can either send Emails immediately or queue them for processing in batches by a :doc:`cron job `. Documentation relating to configuring the queue is in the :doc:`queue ` section. Immediate delivery ------------------ @@ -264,7 +278,7 @@ Mautic works most effectively with high send volumes if you use the queued deliv .. code-block:: shell - php /path/to/mautic/bin/console messenger:consume email_transport + php /path/to/mautic/bin/console messenger:consume email Some hosts may have limits on the number of Emails sent during a specified time frame and/or limit the execution time of a script. If that's the case for you, or if you just want to moderate batch processing, you can configure batch numbers and time limits in Mautic's Configuration. See the :doc:`cron job documentation ` for more specifics. @@ -284,7 +298,7 @@ Mail send settings Ensure that you configure your sender domain, ``DKIM``, bounce, and click tracking domains. For more information, see the :ref:`Email` documentation. -* **Reply to address** - To have Contacts reply to a different address than the specified From address, add the desired address here. This is the default ``reply-to`` address where messages are sent from Mautic unless it is overridden in an individual Email. If this field is blank, the address specified in **Email address to send mail** from is used. The ``reply-to`` setting is useful if your configured sender domain - which you use in the from address - contains a subdomain that doesn't have MX records or is otherwise an address that can't receive Emails. +* **Reply to address** - To have Contacts reply to a different address than the specified From address, add the desired address here. This is the default ``reply-to`` address where messages are sent from Mautic unless it is overridden in an individual Email. If this field is blank, Mautic uses the address specified in **Email address to send mail from**. The ``reply-to`` setting is useful if your configured sender domain - which you use in the from address - contains a subdomain that doesn't have MX records or is otherwise an address that can't receive Emails. * **Custom return path (bounce) address** - Set a custom return path/bounce Email address for Emails sent from the system. Note that some mail transports, such as GMail, won't support this. @@ -302,7 +316,7 @@ See :ref:`here` to set the Contact's Em Default frequency rule ====================== -* **Do not contact more than each ** - This limits the number of Marketing Messages a Contact receives in a certain period of time day, week, month. Transactional messages don't count towards this limit. You can adjust this at the individual Contact level, either manually or by Preference Center setting. +* **Do Not Contact more than each ** - This limits the number of Marketing Messages a Contact receives in a certain period of time day, week, month. Transactional messages don't count towards this limit. You can adjust this at the individual Contact level, either manually or by Preference Center setting. .. note:: @@ -465,9 +479,13 @@ If a Campaign or Webhook is automatically unpublished because of a high volume o * **Send notification to author** - Set this field to Yes to send an Email notification to the User who created the unpublished Campaign or Webhook. Deleted Users don't receive notifications. -Landing page settings +.. vale off + +Landing Page settings ********************* +.. vale on + .. image:: images/landing-page-settings.png :width: 600 :alt: Screenshot showing Landing Page Settings Configuration in Mautic @@ -503,7 +521,7 @@ Mautic tracking settings .. note:: * The tracking code automatically detects the Preferred Timezone and Preferred Locale fields. - * Landing Pages including 4-byte UTF-8 characters, such as emojis and some Chinese or other non-Latin characters, in the Landing Page title or URL aren't tracked on a Contact's activity history in Mautic. All Latin characters used in English and other western languages are of 1-byte and are tracked. + * Landing Pages including 4-byte UTF-8 characters, such as emojis and some Chinese or other non-Latin characters, in the Landing Page title or URL aren't tracked on a Contact's activity history in Mautic. Mautic tracks all Latin characters used in English and other western languages which are of 1-byte. Facebook pixel ============== @@ -514,9 +532,9 @@ Facebook pixel * **Facebook Pixel ID** - Enter your Facebook Pixel ID and select the options you'd like to use the pixel for. -* **Enabled on your tracking landing page** - Select Yes to have Mautic append the Facebook Pixel to the Mautic tracking code to track Landing Pages where the tracking code exists. +* **Enabled on your tracking Landing Page** - Select Yes to have Mautic append the Facebook Pixel to the Mautic tracking code to track Landing Pages where the tracking code exists. -* **Enabled on Mautic landing page** - Select Yes to have Mautic add the Facebook Pixel to Mautic landing pages. +* **Enabled on Mautic Landing Page** - Select Yes to have Mautic add the Facebook Pixel to Mautic Landing Pages. Google analytics @@ -528,9 +546,9 @@ Google analytics * **Google Analytics ID** - Enter your Google Analytics ID and select the options you'd like to use the pixel for. -* **Enabled on your tracking landing page** - Select Yes to have Mautic append the Google Analytics script to the Mautic tracking code to track Landing Pages where the tracking code exists. +* **Enabled on your tracking Landing Page** - Select Yes to have Mautic append the Google Analytics script to the Mautic tracking code to track Landing Pages where the tracking code exists. -* **Enabled on Mautic landing page** - Select Yes to have Mautic add the Google Analytics script to Mautic landing pages. +* **Enabled on Mautic Landing Page** - Select Yes to have Mautic add the Google Analytics script to Mautic Landing Pages. * **Enabled IP** ``Anonymization`` - For subscribers sensitive to General Data Protection Regulation or other data privacy laws and regulations, select Yes to anonymize the IP address of web visitors before sending it to Google Analytics.* diff --git a/docs/links/esp_sendgrid.py b/docs/links/esp_sendgrid.py index e2ed10df..926b938b 100644 --- a/docs/links/esp_sendgrid.py +++ b/docs/links/esp_sendgrid.py @@ -1,7 +1,7 @@ from . import link -link_name = "Sendgrid" -link_text = "Sendgrid" +link_name = "SendGrid" +link_text = "SendGrid" link_url = "https://sendgrid.com" link.xref_links.update({link_name: (link_text, link_url)}) \ No newline at end of file diff --git a/docs/links/mautic_sparkpost_plugin.py b/docs/links/mautic_sparkpost_plugin.py new file mode 100644 index 00000000..2a214eb7 --- /dev/null +++ b/docs/links/mautic_sparkpost_plugin.py @@ -0,0 +1,7 @@ +from . import link + +link_name = "sparkpost-transport" +link_text = "Mautic Sparkpost plugin" +link_url = "https://packagist.org/packages/ts-navghane/sparkpost-plugin" + +link.xref_links.update({link_name: (link_text, link_url)}) From 4f4a29eb6f313f013f761ee8b5916400361b6bed Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Wed, 22 Nov 2023 12:05:01 +0000 Subject: [PATCH 03/46] Fix focus items --- docs/channels/focus_items.rst | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/channels/focus_items.rst b/docs/channels/focus_items.rst index 64e64d24..c32242ea 100644 --- a/docs/channels/focus_items.rst +++ b/docs/channels/focus_items.rst @@ -1,7 +1,7 @@ Focus Items ########### -Focus items allow you to engage Users on your site through bars, modals, notifications, popups, and light boxes. It's possible to initiate Focus Items at different times and with different actions such as exit intent. +Focus Items allow you to engage Users on your site through bars, modals, notifications, popups, and light boxes. It's possible to initiate Focus Items at different times and with different actions such as exit intent. You can find Focus Items listed under the Channels menu. @@ -127,7 +127,7 @@ This editor mode allows a simplified experience with a few fields - depending on - **Select the Form to insert** - This option is only available for Collect Data Focus Item types. It allows you to select an existing Mautic Form to use with the Focus Item. For styling and formatting reasons, you may want to create a Form specifically for the Focus Item, adding styling attributes to the Attributes tab on the Form fields. - **Link text** - This option is only available for Emphasize a Link Focus Item types. It allows you to specify the text used on the Focus Item's button. - **Link URL** - This option is only available for Emphasize a Link Focus Item types. It allows you to specify the URL where you'd like to drive visitors with the Focus Item. -- **Open in a new window** - This option is only available for Emphasize a Link Focus Item types. If set to Yes, this ensures that the link is opened in a new window. If set to No, the link opens in the current tab. +- **Open in a new window** - This option is only available for Emphasize a Link Focus Item types. If set to Yes, this ensures that the link opens in a new window. If set to No, the link opens in the current tab. Editor ~~~~~~ @@ -167,7 +167,7 @@ When creating a new Focus Item, you can set the following fields: .. vale on -**Google Analytics UTM tags** - Mautic supports UTM tagging in Emails, Focus Items, and Landing Pages. Any UTM tags with values populated are automatically appended to the end of any links used in the focus item. See :doc:`/channels/utm_tags` for more information. +**Google Analytics UTM tags** - Mautic supports UTM tagging in Emails, Focus Items, and Landing Pages. Any UTM tags with values populated are automatically appended to the end of any links used in the Focus Item. See :doc:`/channels/utm_tags` for more information. .. image:: images/focus_items/focus_item_create.png :width: 400 @@ -180,7 +180,7 @@ Using the Focus Item builder .. vale on -After you specify the general information for the Focus Item, click the builder option in the top right corner. If you've specified a URL in the Website field on the details page, the system displays a preview. If you don't see a preview, the website might block iframe previews. Hence, you may need to add the focus item to a development or staging environment without these security restrictions - if available - to see the preview. +After you specify the general information for the Focus Item, click the builder option in the top right corner. If you've specified a URL in the Website field on the details page, the system displays a preview. If you don't see a preview, the website might block iframe previews. Hence, you may need to add the Focus Item to a development or staging environment without these security restrictions - if available - to see the preview. .. note:: The preview of the website doesn't appear until you select a style from the options on the Focus Item Builder. @@ -203,11 +203,11 @@ Once you have created your Focus Item, you're ready to publish it to your websit Deploying to a website ====================== -When you save the Focus Item, the code snippet required to display it on your website is shown in a green box on the Focus Item overview. +When you save the Focus Item, Mautic shows the code snippet required to display it on your website in a green box on the Focus Item overview. .. image:: images/focus_items/focus_item_embed.png :width: 400 - :alt: Screenshot showing the Focus Item code to be embedded within a website. + :alt: Screenshot showing the Focus Item code to embed within a website. .. note:: You may need assistance from your web development team to implement the Focus Item tracking code on your website. @@ -233,6 +233,6 @@ Measuring success When using the Emphasize a Link type, Mautic displays the link on the Focus Item overview where you can view the number of unique clicks. -If you change the link in a Focus Item after deployment, all links are listed in the overview. +If you change the link in a Focus Item after deployment, Mautic lists all links in the overview. Additionally, Mautic applies UTM tags on Focus Items to both Form submissions and link clicks. If you are using a Focus Item to submit a Form, it's recommended that you have a Submit Action on the Form to record the UTM tags. \ No newline at end of file From a7117478dfc49727022be1427bac29ebef70e0ff Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Wed, 22 Nov 2023 12:06:34 +0000 Subject: [PATCH 04/46] Fix UTM Tags --- docs/channels/utm_tags.rst | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/channels/utm_tags.rst b/docs/channels/utm_tags.rst index 990d1440..d95c056d 100644 --- a/docs/channels/utm_tags.rst +++ b/docs/channels/utm_tags.rst @@ -17,7 +17,7 @@ Using UTM tags in Mautic To use UTM tags with Google Analytics where they appear in your Google Analytics Dashboard, you must install your Google Analytics tracking code on the resource you are linking to. This synchronizes with your Google Analytics Dashboard and records the UTM tags. -If you use a Mautic landing page, you must go to Settings > Configuration > Tracking Settings, and add your Google Analytics ID. +If you use a Mautic Landing Page, you must go to Settings > Configuration > Tracking Settings, and add your Google Analytics ID. .. image:: images/utm_tags/add_ga_code.png :width: 400 @@ -40,18 +40,18 @@ The following table lists the Google Analytics UTM tags: * - Campaign Source - The referring source of the web activity. It indicates the social network, search engine, newsletter name, or any other specific source driving the traffic. * Examples: ``facebook``, ``twitter``, ``blog``, ``newsletters`` - * UTM code: utm_source + * UTM code: ``utm_source`` * Sample code: ``utm_source=facebook`` * - Campaign Medium - UTM tags - Mautic Documentation * Examples: ``cpc``, ``organic_social`` - * UTM code: utm_medium - * Sample code: utm_medium=paid_social + * UTM code: ``utm_medium`` + * Sample code: ``utm_medium=paid_social`` * - Campaign Name - The specific promotion or Campaign title that you want to track. - * Examples: summer_sale, free_trial - * UTM code: utm_campaign - * Sample code: utm_campaign=summer_sale + * Examples: ``summer_sale``, ``free_trial`` + * UTM code: ``utm_campaign`` + * Sample code: ``utm_campaign=summer_sale`` * - Campaign Content - The Assets within the messages. This non-configurable value auto-populates with the content Asset identifier associated with the specific Asset. * - Campaign Term @@ -86,7 +86,7 @@ Using UTM tags in Focus Items Mautic supports UTM tagging in :doc:`/channels/focus_items`. Mautic can automatically append UTM tags to all links in a Focus Item by entering the appropriate values in the field provided. #. Click Channels > Focus Items -#. Create a new focus item or open an existing one. +#. Create a new Focus Item or open an existing one. #. Locate the Google Analytics UTM tags section on the bottom right. #. Enter the appropriate information in the fields. #. Click Apply. \ No newline at end of file From 1cce1097631b4e3d81eb5f09b2a6d3263741542f Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Wed, 22 Nov 2023 12:07:07 +0000 Subject: [PATCH 05/46] Fix marketing messages --- docs/channels/marketing_messages.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/channels/marketing_messages.rst b/docs/channels/marketing_messages.rst index 90adf48e..93c7f4bc 100644 --- a/docs/channels/marketing_messages.rst +++ b/docs/channels/marketing_messages.rst @@ -6,7 +6,7 @@ What are Marketing Messages? Located under the Channels section in Mautic, Marketing Messages is one of the Channels available to you through which you can optimize and personalize communication with your customers. -Marketing messages allow you to empower the customer to decide how they prefer to receive the content you send, by setting the Channel they prefer. +Marketing Messages allow you to empower the customer to decide how they prefer to receive the content you send, by setting the Channel they prefer. .. image:: images/marketing_messages/marketing-messages.png :width: 200 From 5a569b13ba8b1c5fd2dfa49ec54e9f6a0dffaec7 Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Wed, 22 Nov 2023 12:09:04 +0000 Subject: [PATCH 06/46] Fix how to install Mautic --- docs/getting_started/how_to_install_mautic.rst | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/docs/getting_started/how_to_install_mautic.rst b/docs/getting_started/how_to_install_mautic.rst index d5aef0c6..dd6c86f3 100644 --- a/docs/getting_started/how_to_install_mautic.rst +++ b/docs/getting_started/how_to_install_mautic.rst @@ -35,7 +35,7 @@ Before installing a package, ensure that: * Your server has enough free disk space to run the installation. Consider the database size as well. -* PHP's `max_execution_time` is at least 240 seconds. +* PHP's ``max_execution_time`` is at least 240 seconds. Downloading a production package ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -257,7 +257,7 @@ Cloning Mautic from GitHub 1. Install the :xref:`GitHub CLI` tool. -2. Click **Fork** at the top-right corner of the Mautic GitHub repository page to make a personal fork. You can also click to go directly to your fork if you already have one, if you don't then GitHub will offer to create one.. +2. Click **Fork** at the top-right corner of the Mautic GitHub repository to make a personal fork. You can also click to go directly to your fork if you already have one, if you don't then GitHub offers to create one. 3. After the fork is complete, click the green **Code** button to access the command for cloning the repository. @@ -274,8 +274,7 @@ Cloning Mautic from GitHub Install Mautic using DDEV ========================== -You can use :xref:`DDEV` which is recommended for testing and development with Mautic. To get started: - +You can use :xref:`DDEV` which Mautic recommends for testing and development. To get started: #. Install :xref:`DDEV`. From 7c5d30e50f7fe5bab3e3fdd955668f173ab0fbd3 Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Wed, 22 Nov 2023 12:09:42 +0000 Subject: [PATCH 07/46] Fix push notifications --- docs/channels/push_notifications.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/channels/push_notifications.rst b/docs/channels/push_notifications.rst index ef27b1fe..4fcbdc7f 100644 --- a/docs/channels/push_notifications.rst +++ b/docs/channels/push_notifications.rst @@ -1,7 +1,7 @@ Mobile push notifications ########################### -Mobile notifications integrate your iOS and Android app with :xref:`OneSignal`. Using your own OneSignal account, you can now push a notification to your Contacts's mobile device - with their permission. Enable the Plugin in Mautic's Plugin manager to see Mobile Notifications listed under Channels in the menu. +Mobile notifications integrate your iOS and Android app with :xref:`OneSignal`. Using your own OneSignal account, you can now push a notification to your Contact's mobile device - with their permission. Enable the Plugin in Mautic's Plugin manager to see Mobile Notifications listed under Channels in the menu. For more detailed information see the :xref:`OneSignal iOS` and :xref:`OneSignal Android` documentation. From 5853f5fa7992b60b4237be35d11b8f8a2bdca71d Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Wed, 22 Nov 2023 12:11:19 +0000 Subject: [PATCH 08/46] Fix social monitoring --- docs/channels/social_monitoring.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/channels/social_monitoring.rst b/docs/channels/social_monitoring.rst index 177e5370..54417724 100644 --- a/docs/channels/social_monitoring.rst +++ b/docs/channels/social_monitoring.rst @@ -10,7 +10,7 @@ It's possible to add Contacts to Mautic through monitoring Twitter for mentions Requirements ************ -- The :doc:`/plugins/twitter` plugin must be configured +- You must first configure the :doc:`/plugins/twitter` Plugin - You must trigger the Social Monitoring :doc:`cron job ` periodically. .. vale off @@ -42,7 +42,7 @@ When selecting the Twitter Mention monitoring method, the following fields are a There are also the standard Mautic fields available: -**Published** - This allows you to set the published status of the Social Monitor. Unpublished Social Monitors will not collect new Contacts. +**Published** - This allows you to set the published status of the Social Monitor. Unpublished Social Monitors won't collect new Contacts. .. vale off From fc8564931d16bcf7aae01594e4a86c3787fa0ce9 Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Wed, 22 Nov 2023 12:11:54 +0000 Subject: [PATCH 09/46] Fix web notifications --- docs/channels/web_notifications.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/channels/web_notifications.rst b/docs/channels/web_notifications.rst index 40232b98..8c977013 100644 --- a/docs/channels/web_notifications.rst +++ b/docs/channels/web_notifications.rst @@ -3,7 +3,7 @@ Web notifications Web Notifications can be an extremely powerful tool for the marketer. Mautic integrated with :xref:`OneSignal` which allows you to push information to a Contact as they browse through web resources (Mautic Landing Pages, or with some configuration (see :xref:`OneSignal web push`), on your own website), giving you one more Channel that you can use to build a relationship with them. -Web notifications in Mautic use OneSignal by default. Using your own OneSignal account, you can now push a notification to your Contacts's browser - with their permission. Enable the OneSignal Plugin in Mautic's Configuration to see Web Notifications listed under Channels in the menu. +Web notifications in Mautic use OneSignal by default. Using your own OneSignal account, you can now push a notification to your Contact's browser - with their permission. Enable the OneSignal Plugin in Mautic's Configuration to see Web Notifications listed under Channels in the menu. For more information see the OneSignal :xref:`OneSignal web push quickstart` documentation. From fc8d9876ba6c437db7f84dcc9cfbcd185b6c8766 Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Wed, 22 Nov 2023 12:12:42 +0000 Subject: [PATCH 10/46] Fix SMS --- docs/channels/sms.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/channels/sms.rst b/docs/channels/sms.rst index 197b7899..c0086734 100644 --- a/docs/channels/sms.rst +++ b/docs/channels/sms.rst @@ -22,7 +22,7 @@ Template Text Messages .. vale on -A template Text Message is automatically sent by Campaigns, Forms, Point triggers etc. You can edit Template Text Messages after creation, but they can't manually send them to a Contact list. +A template Text Message is automatically sent by Campaigns, Forms, Point Triggers etc. You can edit Template Text Messages after creation, but they can't manually send them to a Contact list. .. vale off From 13abd26a34856c8ac27e024110c05a82a730d0f1 Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Wed, 22 Nov 2023 12:14:35 +0000 Subject: [PATCH 11/46] Fix segments --- docs/segments/manage_segments.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/segments/manage_segments.rst b/docs/segments/manage_segments.rst index 90999396..c794ffc7 100644 --- a/docs/segments/manage_segments.rst +++ b/docs/segments/manage_segments.rst @@ -16,7 +16,7 @@ When viewing all Segments, the **# contacts** column on the right shows the numb :alt: Screenshot showing Contacts matching that particular Segment. .. note:: - Mautic renamed lead lists to Segments in Mautic :xref:`1.4.0 release`. + Mautic renamed ``lead lists`` to ``Segments`` in Mautic :xref:`1.4.0 release`. .. vale off @@ -398,7 +398,7 @@ Learn more about :xref:`Regex`. .. note:: - MySQL (and Mautic) uses POSIX regular expressions, which could behave differently from other types of regular expressions. + MySQL (and Mautic) uses ``POSIX`` regular expressions, which could behave differently from other types of regular expressions. .. vale off From e363fc9f4b929a5e22036f38156fa55f14ed0ec9 Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Wed, 22 Nov 2023 12:15:55 +0000 Subject: [PATCH 12/46] Fix reports --- docs/reports/reports.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/reports/reports.rst b/docs/reports/reports.rst index 3e51bfae..a3f9057f 100644 --- a/docs/reports/reports.rst +++ b/docs/reports/reports.rst @@ -95,7 +95,7 @@ The parent data source provides a high-level summary of the data while the child * **Dynamic filters settings** - Show opened by default - If you want to ensure that the date filters and filter options for any other Report filters are visible on a Report detail page without needing to open the filters drop-down, select Yes. For example, for an Emails Report, you might want to view dynamic filters for subject or sent date. - - Hide date range - To hide the date range filter so that Users can’t change the dates that the Report displays data for, select to **Yes**. + - Hide date range - To hide the date range filter so that Users can't change the dates that the Report displays data for, select to **Yes**. Data @@ -124,7 +124,7 @@ You can customize each Report to include the columns of choice, filter data base You can use Email or Contact ID to display a single row per Contact record. For example, you can group by **Contact ID** to view the unique number of Asset Downloads or Form Submissions for a single Form, instead of total Asset Downloads or Form Submissions, which could include duplicates. -* **Calculated columns** - Select the function that you want to apply to individual columns. Calculated columns display count, average, sum, or the minimum or maximum values from a selected field. They're only available when using a grouping to show a calculation for that grouping. Continuing with the previous example of grouping by a Contact ID number or Email address, a COUNT calculation displays how many times that Contact record appears on the Report if not for the grouping. +* **Calculated columns** - Select the function that you want to apply to individual columns. Calculated columns display count, average, sum, or the minimum or maximum values from a selected field. They're only available when using a grouping to show a calculation for that grouping. Continuing with the previous example of grouping by a Contact ID number or Email address, a ``COUNT`` calculation displays how many times that Contact record appears on the Report if not for the grouping. Graphs ====== From eb6212fa5995eed47703d132a20e423e0e04bd54 Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Wed, 22 Nov 2023 12:23:56 +0000 Subject: [PATCH 13/46] fix updating mautic page --- docs/getting_started/how_to_update_mautic.rst | 24 +++++++++---------- 1 file changed, 11 insertions(+), 13 deletions(-) diff --git a/docs/getting_started/how_to_update_mautic.rst b/docs/getting_started/how_to_update_mautic.rst index 1078d0ef..a4ffec5e 100644 --- a/docs/getting_started/how_to_update_mautic.rst +++ b/docs/getting_started/how_to_update_mautic.rst @@ -25,9 +25,9 @@ This means that you have downloaded the files and database of your Mautic instan Checking for updates at the command line ======================================== -Mautic can only be updated using Composer via the command line from version 5.0. +From Mautic 5, you can only update Mautic via the command line. -The update feature within the Mautic User interface (UI) has been deprecated from Mautic 4.2, but you will be alerted within the UI (see below figure) when a new version of the Mautic is available. +Mautic 4.2 deprecated the update feature within the Mautic User Interface, but Mautic alerts you - see below - when a new version is available. .. image:: images/gui-update-deprecated.png :width: 700 @@ -35,7 +35,7 @@ The update feature within the Mautic User interface (UI) has been deprecated fro :alt: Screenshot showing deprecated update feature warning .. warning:: - Before starting to upgrade, it's highly recommended to take a backup of your instance. If updates are available, you will receive an update notification followed by step-by-step instructions in the command-line interface to complete the process. + Before starting to upgrade, it's highly recommended to take a backup of your instance. If updates are available, an update notification displays followed by step-by-step instructions in the command-line interface to complete the process. Log in via the command line, and change directory to the Mautic directory using the command: @@ -43,20 +43,18 @@ Log in via the command line, and change directory to the Mautic directory using cd /your/mautic/directory - - The first step is to find out if there are any updates available using the following command: .. code-block:: shell php bin/console mautic:update:find -The output from this command tells you if there are any updates to apply. The notification links to an announcement post which explains what the release includes, and the recommended environment requirements if they are not being met (for example, a higher version of PHP must be installed or plugins that must be updated). +The output from this command tells you if there are any updates to apply. The notification links to an announcement post which explains what the release includes, and the recommended environment requirements if they're not met - for example, a higher version of PHP needed or Plugins that need updating. .. note:: It's a good idea to review the announcement link for information about the release. There may be important information or steps that you may need to take before updating. -After a system readiness check, you can apply the updates. +After confirming system readiness, you can apply the updates. Installing updates at the command line ====================================== @@ -68,7 +66,7 @@ If there are updates available, run the following command to apply them: php bin/console mautic:update:apply -This is followed by a prompt to run the command again with this additional argument: +Next, a prompt displays asking you to run the command again with this additional argument: .. code-block:: shell @@ -82,11 +80,11 @@ When updating Mautic, there are several tasks which can take a long time to comp .. warning:: - If you have a lot of contacts and/or use shared hosting, you might run into problems when updating with the notification 'bell' icon in Mautic. + If you have a lot of Contacts and/or use shared hosting, you might run into problems when updating with the notification 'bell' icon in older versions of Mautic. When updating within the browser, problems usually manifest as the update hanging part way through, or crashing with an error. They often arise as a result of resource limitation, particularly on shared hosting environments. -For this reason, it's always recommended that you :ref:`update at the command line` wherever possible. From Mautic 5.0 the ability to update in the browser will be completely removed, and you will have to update at the command line. +For this reason, it's **always recommended** that you :ref:`update at the command line` wherever possible. From Mautic 5.0 the ability to update in the browser is completely removed, and you have to update at the command line. Before you commence updating, **please ensure that you have a tested backup of your Mautic instance**. @@ -127,9 +125,9 @@ What to do if you need help updating Mautic If you need help, you can ask for it in several places. You should remember that most members of the Community Forums, Slack, and GitHub are volunteers. -- The :xref:`Mautic Community Forums` is the place where you can ask questions about your configuration if you think it is the cause of the problem. Please search before posting your question, since someone may have already answered it. +- The :xref:`Mautic Community Forums` is the place where you can ask questions about your configuration if you think it's the cause of the problem. Please search before posting your question, since someone may have already answered it. -- The live :xref:`Mautic Community Slack` is also available, but all support requests have to be posted on the forums. Create your request there first, then drop a link in Slack if you plan to discuss it there. +- The live :xref:`Mautic Community Slack` is also available, but you must post all support requests on the forums. Create your request there first, then drop a link in Slack if you plan to discuss it there. In all cases, it's important to provide details about the issue, as well as the steps you have taken to resolve it. At a minimum, include the following: @@ -140,4 +138,4 @@ In all cases, it's important to provide details about the issue, as well as the If you don't provide the information requested as a minimum, the person who might try to help you has to ask you for it, so please save them the trouble and provide the information upfront. Also, importantly, please be polite. Mautic is an open source project, and people are giving their free time to help you. -If you are sure that you have discovered a bug and you want to report it to developers, you can :xref:`Mautic Github New Issue` on GitHub. GitHub is not the right place to request support or ask for help with configuration errors. Always post on the forums first if you aren't sure, if a bug report is appropriate this can link to the forum thread. \ No newline at end of file +If you are sure that you have discovered a bug and you want to report it to developers, you can :xref:`Mautic Github New Issue` on GitHub. GitHub isn't the right place to request support or ask for help with configuration errors. Always post on the forums first if you aren't sure, if a bug report is appropriate this can link to the forum thread. \ No newline at end of file From 1241b59f56d08299457f46b9510bf74477d6f7ca Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Wed, 22 Nov 2023 15:30:35 +0000 Subject: [PATCH 14/46] fix switch to composer --- docs/getting_started/switching_composer.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/getting_started/switching_composer.rst b/docs/getting_started/switching_composer.rst index cd3ac47d..ccafb4bb 100644 --- a/docs/getting_started/switching_composer.rst +++ b/docs/getting_started/switching_composer.rst @@ -6,11 +6,11 @@ How to switch to Composer .. vale on Until Mautic 4, you could download Mautic as a ZIP file and install it on any PHP server. -However, many users were running into installation and update errors, many of which caused considerable frustration and in some cases, significant business disruption. +However, many Mautic Users were running into installation and update errors, many of which caused considerable frustration and in some cases, significant business disruption. In addition, Mautic recently introduced the :ref:`Mautic Marketplace` which isn't compatible with this installation method. -As a result of the reasons mentioned above, Composer becomes the default method for installing and updating Mautic starting with the release of Mautic 5. Read more in the :xref:`composer blog post`. +As a result of the reasons mentioned previously, Composer becomes the default method for installing and updating Mautic starting with the release of Mautic 5. Read more in the :xref:`composer blog post`. Switching to a Composer-based installation ****************************************** @@ -49,7 +49,7 @@ Here's the steps to follow to switch to a Composer-based installation: #. Update your web server configuration to point to ``/var/www/html/docroot`` instead of ``/var/www/html`` -#. Log in to Mautic, and in your global settings enable the switch to fully manage Mautic with Composer - this will also enable you to work with the Mautic Marketplace. +#. Log in to Mautic, and in your global settings enable the switch to fully manage Mautic with Composer - this also enables you to work with the Mautic Marketplace. .. image:: images/switch-enable-composer.png :width: 600 @@ -59,8 +59,8 @@ You have successfully switched to a Composer-based installation. Test Mautic to .. vale off -Frequently Asked Questions (FAQs) -********************************* +Frequently Asked Questions +************************** Q: Is existing data retained? From 1c21fc81fac96fecca310f501fc92ce14c4feec1 Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Wed, 22 Nov 2023 15:32:10 +0000 Subject: [PATCH 15/46] fix companies --- docs/companies/companies_overview.rst | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/companies/companies_overview.rst b/docs/companies/companies_overview.rst index 786269f4..73515e22 100644 --- a/docs/companies/companies_overview.rst +++ b/docs/companies/companies_overview.rst @@ -24,7 +24,7 @@ You can find a table with the list of the assigned Contacts displaying the date Company duplicates ******************* -The Company name field is a unique identifier by default. You can choose any other Company field as unique identifier in the **custom fields** section. +The Company name field is a unique identifier by default. You can choose any other Company field as unique identifier in the **Custom Fields** section. In *Configuration > Company Settings* you can choose the operator used when merging Companies with multiple identifiers - either **AND** or **OR**. @@ -63,7 +63,7 @@ By default, a set of fields exist for Companies, but you can customize these fie #. Change the dropdown select box from Contact to Company objects -#. Save the custom field +#. Save the Custom Field .. vale off @@ -138,10 +138,10 @@ Through a Form When identifying a Contact through a Form, you can also associate an existing Company or create a new one if: -- The Form includes Company name as a Form field - mandatory for Company matching/creation, -- The Form includes City as a Form field - mandatory for Company matching/creation), -- The Form includes Country as a form field - mandatory for Company matching/creation, -- The Form includes State as a form field - optional for Company matching/creation. +- The Form includes Company name as a Form Field - mandatory for Company matching/creation, +- The Form includes City as a Form Field - mandatory for Company matching/creation, +- The Form includes Country as a Form Field - mandatory for Company matching/creation, +- The Form includes State as a Form Field - optional for Company matching/creation. Company scoring ================ From 423ce9100094597ec43abfa74f945306f588c80a Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Wed, 22 Nov 2023 15:33:35 +0000 Subject: [PATCH 16/46] Campaigns --- docs/campaigns/campaign_builder.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/campaigns/campaign_builder.rst b/docs/campaigns/campaign_builder.rst index ce629ed3..fa97c7f3 100644 --- a/docs/campaigns/campaign_builder.rst +++ b/docs/campaigns/campaign_builder.rst @@ -198,16 +198,16 @@ Here are the different conditions that Mautic offers in the Campaign Builder: * - **Contact device** - Checks if the Contact has interacted with your Campaign from a specific device type, brand, or OS. * - **Contact field value** - - Checks if the information matches the selected criteria on the Contact record, the Contact’s primary Company, or UTM tags. + - Checks if the information matches the selected criteria on the Contact record, the Contact's primary Company, or UTM tags. * - **Contact owner** - Checks if the selected User is the Contact's owner. * - **Contact Segments** - Checks if the Contact is a member of selected Segments. * - **Contact Tags** - Checks if specified Tags are on the Contact record. - * - **Contact points** + * - **Contact Points** - Checks if the Contact has a certain number of Points or a Group score. - * - **Form field value** + * - **Form Field value** - Checks if values submitted for a selected field on a selected Form matches specified criteria. * - **Has active notification** - Checks if the Contact has an active web notification. From efab588f24bddca398a1bfc15f9cb159ef8e2350 Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Wed, 22 Nov 2023 15:38:38 +0000 Subject: [PATCH 17/46] Fix forms --- .github/styles/Mautic/FeatureList.yml | 4 ++-- .github/styles/Vocab/Mautic/accept.txt | 4 ++++ docs/components/forms.rst | 8 ++++---- 3 files changed, 10 insertions(+), 6 deletions(-) diff --git a/.github/styles/Mautic/FeatureList.yml b/.github/styles/Mautic/FeatureList.yml index a83f4872..a0c65bd1 100644 --- a/.github/styles/Mautic/FeatureList.yml +++ b/.github/styles/Mautic/FeatureList.yml @@ -45,8 +45,8 @@ swap: point actions: Point Actions point triggers: Point Triggers points: Points - group: Group - groups: Groups + point group: Point Group + point groups: Point Groups plugin: Plugin plugins: Plugins report: Report diff --git a/.github/styles/Vocab/Mautic/accept.txt b/.github/styles/Vocab/Mautic/accept.txt index 5b0922fc..979f9735 100644 --- a/.github/styles/Vocab/Mautic/accept.txt +++ b/.github/styles/Vocab/Mautic/accept.txt @@ -6,6 +6,7 @@ Autoloader autoloader Autowired autowired +Azure bcc Beanstalkd Bing @@ -18,6 +19,7 @@ CCPA Citrix Clearbit CloudAMQP +CMS config Company(ies) Composer @@ -25,6 +27,7 @@ configurator ConnectWise Contribution(s) CORS +CRM cron Cron CTRL @@ -41,6 +44,7 @@ Focus Items Froala Froogaloop gcm +GDPR GIF GitBook GitHub diff --git a/docs/components/forms.rst b/docs/components/forms.rst index 153c1877..b0965d5d 100644 --- a/docs/components/forms.rst +++ b/docs/components/forms.rst @@ -38,7 +38,7 @@ The following fields are available: - **Kiosk mode** - If Yes, Mautic turns off tracking of Contacts created through the Form, so that the Form doesn't generate cookies or associate any IP address with the Contact record. Marketers may refer to this as 'data entry mode'. It's ideal for using at conferences or events where several Contacts may enter their information using the same device, as it prevents associating the activity on the device to Contacts. -- **Render style** - If Yes, the Form displays with the styling from either the selected Mautic Theme or the Attributes tab of the Form fields. When No, the Form adopts the styling of where it's embedded. +- **Render style** - If Yes, the Form displays with the styling from either the selected Mautic Theme or the Attributes tab of the Form Fields. When No, the Form adopts the styling of where it's embedded. - **Theme** - Select a Mautic Theme which has styling for a Form. This dictates the styling of the Form when added to an external website or Application if 'Render style' is Yes. @@ -142,7 +142,7 @@ Based on the field selected, Mautic displays various tabs in the fields editor i General ~~~~~~~ -- **Label** - This is the title of your field, telling the visitor what you'd like them to enter in the field. The label shows before the Form field by default. +- **Label** - This is the title of your field, telling the visitor what you'd like them to enter in the field. The label shows before the Form Field by default. - **Show label?** - When No, Mautic won't display the label on the Form. @@ -199,7 +199,7 @@ Checkbox group, radio group and select .. image:: images/forms/checkbox_field_values.png :width: 600 - :alt: Screenshot showing checkbox field values with a mapped custom field + :alt: Screenshot showing checkbox field values with a mapped Custom Field With the checkbox, radio box and select fields, the properties tab allows you to choose what should be available for the visitor to select. @@ -449,7 +449,7 @@ Creating Custom Fields .. vale on -Using an example of wanting to show specific types of car based on the manufacturer, you would create the following custom fields: +Using an example of wanting to show specific types of car based on the manufacturer, you would create the following Custom Fields: - **Car manufacturer**: this field should be of the Select data type. In this example, the options for this field are Ford, Nissan, Peugeot, and Fiat. - **Ford cars**: this field should be of the Select - Multiple data type. In this example, the available options for this field are Focus, Mustang, Fiesta, and Galaxy. From 387c67db2a7d5deb52a54ff4e8ac34ad29a8e5ac Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Wed, 22 Nov 2023 15:39:51 +0000 Subject: [PATCH 18/46] Fix themes --- docs/themes/manage_themes.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/themes/manage_themes.rst b/docs/themes/manage_themes.rst index 78191899..923c5fc2 100644 --- a/docs/themes/manage_themes.rst +++ b/docs/themes/manage_themes.rst @@ -67,7 +67,7 @@ Deleting a Theme .. vale on -To delete a user-created Theme: +To delete a User-created Theme: 1. Log in to Mautic. @@ -149,7 +149,7 @@ You can assign your Mautic instance a default Theme for Landing Pages. Then use .. note:: - Changing the Theme after building the Page may cause content to not display if the two Themes don't use the same placeholders. + Changing the Theme after building the Landing Page may cause content to not display if the two Themes don't use the same placeholders. To assign a default Theme: From a5f7eef93f258b7bef330aa187979e1426817592 Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Wed, 22 Nov 2023 15:41:47 +0000 Subject: [PATCH 19/46] fix categories --- docs/categories/categories-overview.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/categories/categories-overview.rst b/docs/categories/categories-overview.rst index 4c4a32eb..4f570a59 100644 --- a/docs/categories/categories-overview.rst +++ b/docs/categories/categories-overview.rst @@ -32,11 +32,11 @@ Using Categories for Contacts .. vale on -In addition to organizing various Mautic elements Categories can be used to organize Contacts. In Contact details use the Preference menu to open Contact Preference Center. +In addition to organizing various Mautic elements Categories can help you organize Contacts. In Contact details use the Preference menu to open Contact Preference Center. .. image:: images/assign-category-to-contact.jpeg :width: 600 :alt: Screenshot of assigning Category to Contact -Contact Categories can be used in Segment and dynamic content filters. +Mautic allows the assignment of Contact Categories in Segment and Dynamic Content filters. From 9573126882e6c1b2cdd1e11637f5156c156ea1fc Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Wed, 22 Nov 2023 15:43:36 +0000 Subject: [PATCH 20/46] Campaigns --- docs/campaigns/creating_campaigns.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/campaigns/creating_campaigns.rst b/docs/campaigns/creating_campaigns.rst index 1d36a24a..f9121209 100644 --- a/docs/campaigns/creating_campaigns.rst +++ b/docs/campaigns/creating_campaigns.rst @@ -19,10 +19,10 @@ following set up: #. Create a Contact Segment or a Form to initialize your Campaign. If you already have an existing Segment or Form to use, ensure that they're up-to-date. -#. Create any custom field that you need for your Contact profile. +#. Create any Custom Field that you need for your Contact profile. #. Set up and configure any Integration that you intend to use in your Campaign. -#. Set up appropriate Channels such as Text Messages, Email, Focus items to communicate with your Contacts. -#. Create Assets, Landing pages, or other Components that you want to use for your Campaign. If using Assets, ensure that you upload them before creating your Campaign. +#. Set up appropriate Channels such as Text Messages, Email, Focus Items to communicate with your Contacts. +#. Create Assets, Landing Pages, or other Components that you want to use for your Campaign. If using Assets, ensure that you upload them before creating your Campaign. Although you can set up Channels and create Components during the process of creating the Campaign, it's ideal to have them ready beforehand as it makes the Campaign building process faster and more efficient. From f4e6988d6b646e50f922cdeed74b09c0ea4c0fa8 Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Wed, 22 Nov 2023 15:52:53 +0000 Subject: [PATCH 21/46] manage contacts --- .github/styles/Vocab/Mautic/accept.txt | 1 + docs/contacts/manage_contacts.rst | 72 ++++++++++++++------------ 2 files changed, 39 insertions(+), 34 deletions(-) diff --git a/.github/styles/Vocab/Mautic/accept.txt b/.github/styles/Vocab/Mautic/accept.txt index 979f9735..a7adbb66 100644 --- a/.github/styles/Vocab/Mautic/accept.txt +++ b/.github/styles/Vocab/Mautic/accept.txt @@ -94,6 +94,7 @@ post PUT Rackspace Remarketing +REST Salesforce SAML Schimpf diff --git a/docs/contacts/manage_contacts.rst b/docs/contacts/manage_contacts.rst index 9af04b64..401a4e27 100644 --- a/docs/contacts/manage_contacts.rst +++ b/docs/contacts/manage_contacts.rst @@ -14,7 +14,7 @@ Searching for Contacts .. vale on -You can search within a Segment using the box at the top of the list, or order Contacts by using the table headings - click on the relevant table heading. +You can search within a Segment using the box at the top of the list, or order Contacts by using the table headings - click the relevant table heading. .. image:: images/contacts-search.jpeg :align: center @@ -44,9 +44,13 @@ Quick Add is a short Form with the fields you deem most important. To display fi You can add the Contact through the New Contact Form and include much more detail, but for quick entry this is the easiest and fastest way to get the Contact into the system. +.. vale off + Add new Contact =============== +.. vale on + .. image:: images/contact-manual-add.png :align: center :alt: Screenshot of Contact Manual Add @@ -111,7 +115,7 @@ When Mautic tracks a Contact's actions - such as page hits or Form submissions - * Cookie -Mautic merges all actions to the Contact with the same cookie or creates a new cookie if it knows the unique `device_id`. +Mautic merges all actions to the Contact with the same cookie or creates a new cookie if it knows the unique ``device_id``. If a Contact sends a Form with an Email address, it merges the submission with the Contact having the same Email address. This happens even if the IP address or the cookie matches another Contact. @@ -134,7 +138,7 @@ A modal window displays when you click one of the actions, with more configurati -You can use this feature to quickly update large volumes of Contacts, but it might be better to use a Campaign action - for example add all the Contacts you need to update into a segment and use a campaign to trigger the change - if you need to change more than a few hundred Contacts at a time. +You can use this feature to quickly update large volumes of Contacts, but it might be better to use a Campaign action - for example add all the Contacts you need to update into a Segment and use a Campaign to trigger the change - if you need to change more than a few hundred Contacts at a time. .. image:: images/batch-actions.png :width: 200 @@ -178,16 +182,16 @@ The Engagements line chart display how active the Contact was in the past 6 mont Image ===== -* **Gravatar** - By default, Mautic pulls images from Gravatar. If there’s a :xref:`Gravatar` associated with the Contact’s Email address, Mautic will add the Gravatar photo to the contact record. +* **Gravatar** - By default, Mautic pulls images from Gravatar. If there's a :xref:`Gravatar` associated with the Contact's Email address, Mautic adds the Gravatar photo to the Contact record. * **Custom** - To add a custom image file to a Contact, edit the Contact record and look for **Preferred profile image** under the image placeholder. -* **Social** - If you’ve enabled social Plugins and the record includes a social profile, you’ll see options to pull in profile images. +* **Social** - If you've enabled social Plugins and the record includes a social profile, you'll see options to pull in profile images. History ======= -Event history tracks any engagements between Mautic and a Contact. To find certain event types, search in the **Include events by source** text box. To exclude event types from the history while you’re looking at it, use **Exclude events by source**. +Event history tracks any engagements between Mautic and a Contact. To find certain event types, search in the **Include events by source** text box. To exclude event types from the history while you're looking at it, use **Exclude events by source**. **Accessed from IP** - IP addresses which the Contact has opened or clicked Emails, visited your tracked pages, etc. from. @@ -197,7 +201,7 @@ Event history tracks any engagements between Mautic and a Contact. To find certa **Campaign Action Triggered** - Actions within Campaigns which have already happened. -**Campaign Event Scheduled** - Actions within Campaigns which take place in the future. Expand the details to see the event’s scheduled date and time. Click the clock icon to reschedule the event, or click **X** to cancel the event. A warning icon means an execution error on the first try caused a rescheduling of the event. +**Campaign Event Scheduled** - Actions within Campaigns which take place in the future. Expand the details to see the event's scheduled date and time. Click the clock icon to reschedule the event, or click **X** to cancel the event. A warning icon means an execution error on the first try caused a rescheduling of the event. **Campaign Membership Change** - Changes to which Campaign a Contact is a part of. @@ -213,7 +217,7 @@ Event history tracks any engagements between Mautic and a Contact. To find certa **Dynamic Content sent** - When the Contact has a Dynamic Content slot pushed to them through a Campaign action. -**Email Failed** - If an Email to the Contact reports back as the Email address being an invalid address or the Email being undeliverable, Mautic displays an Email failed event with the internal name of the Email shown. +**Email Failed** - If an Email to the Contact returns back as the Email address being an invalid address or the Email being undeliverable, Mautic displays an Email failed event with the internal name of the Email shown. **Email Read** - The date and time when a specific Email was first read. If the Contact opens the Email multiple times, expanding details on the event type displays the additional opens. @@ -231,7 +235,7 @@ Event history tracks any engagements between Mautic and a Contact. To find certa **Integration Sync Notice** - Information about connections with Integrations. -**Message Queue** - When exceeding a Contact’s frequency limits for a Channel and a message on that Channel later triggers to send, a Message Queue event displays with the Channel and the ID for the message that's queued. Expanding details displays: +**Message Queue** - When exceeding a Contact's frequency limits for a Channel and a message on that Channel later triggers to send, a Message Queue event displays with the Channel and the ID for the message that's queued. Expanding details displays: * originally scheduled send date * rescheduled send date @@ -239,7 +243,7 @@ Event history tracks any engagements between Mautic and a Contact. To find certa If the message is ``Pending``, clicking the X button cancels it. -**Page Hit** - Time and date of page visits, and the URL if it’s a tracked page on your site or the internal name of a Mautic Landing Page. You may view more information, if tracked, by expanding the details of this event type. +**Page Hit** - Time and date of page visits, and the URL if it's a tracked page on your site or the internal name of a Mautic Landing Page. You may view more information, if tracked, by expanding the details of this event type. **Point Gained** The ID number of either: @@ -253,7 +257,7 @@ If the message is ``Pending``, clicking the X button cancels it. **Text Message Received** - This event type is for SMS replies, if you are using SMS and have SMS reply tracking configured. Outbound SMS display as ``Campaign Event Scheduled`` or ``Campaign Action Triggered``. -**UTM Tags Recorded** - If you’re using UTM tags and record them from a Form submission, landing page hit, etc., Mautic displays them here. Expanding the details displays the recorded tags. +**UTM Tags Recorded** - If you're using UTM tags and record them from a Form submission, Landing Page hit, etc., Mautic displays them here. Expanding the details displays the recorded tags. **Video View Event** - Details in this event type include the length of time a prospect watched the video, the percentage of the video watched, the page where the video displays - known as Referrer - and the URL of the video file. @@ -272,7 +276,7 @@ If a Contact record includes social profiles, you can see them in the **Social** Integrations ============ -If the Contact exists in other tools has connections through Plugin or API Integrations, you’ll see those here. This helps identify where a Contact came from, or what other internal systems the Contact exists in. +If the Contact exists in other tools has connections through Plugin or API Integrations, you'll see those here. This helps identify where a Contact came from, or what other internal systems the Contact exists in. Map === @@ -370,7 +374,7 @@ Make sure you enter your website URL correctly as outlined in the :doc:`CORS set Note that if a browser doesn't accept cookies, this may result in each hit creating a new visitor. -.. code-block:: +.. code-block:: javascript + mt('send', 'pageview'); + *Don't forget to change the scheme (http(s)) either to http or https depending what scheme you use for your Mautic. Also, change [example.com] to the domain where your Mautic runs.* @@ -397,8 +401,8 @@ The advantage of JavaScript tracking is that the tracking request - which can ta * **Page URL** the URL of the current website. -mt() events -~~~~~~~~~~~ +``mt() events`` +~~~~~~~~~~~~~~~ mt() supports two callbacks, ``onload`` and ``onerror`` accepted as the fourth argument. The ``onload`` method fires at loading of the pixel. If the pixel fails for whatever reason, it triggers ``onerror``. @@ -690,9 +694,13 @@ How to test Google Analytics tracking code and campaign action | -How to test Facebook Pixel tracking code and campaign action +.. vale off + +How to test Facebook Pixel tracking code and Campaign action ------------------------------------------------------------ +.. vale on + * Install the Facebook Pixel Helper * Create Campaign with a 'Visits a Page' decision and a 'Send tracking event' action * Test it and verify in the Facebook Pixel Helper debug window that you see one ``Pageview`` and one custom event action From 53a60a3fe948a5caa22d3c031dda2354ccb929d8 Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Fri, 22 Dec 2023 15:47:41 +0000 Subject: [PATCH 27/46] Points - MQLs --- .github/styles/Vocab/Mautic/accept.txt | 2 ++ 1 file changed, 2 insertions(+) diff --git a/.github/styles/Vocab/Mautic/accept.txt b/.github/styles/Vocab/Mautic/accept.txt index a7adbb66..8fd7465e 100644 --- a/.github/styles/Vocab/Mautic/accept.txt +++ b/.github/styles/Vocab/Mautic/accept.txt @@ -75,6 +75,8 @@ MaxMind Middlewares middlewares MJML +MQL +MQLs Multiselect multiselect MVP From 5f1f6ba09849c215032a1afb4d4b02230094d86f Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Fri, 22 Dec 2023 15:51:05 +0000 Subject: [PATCH 28/46] Point groups --- docs/points/point_groups.rst | 34 +++++++++++++++++++++++++++------- 1 file changed, 27 insertions(+), 7 deletions(-) diff --git a/docs/points/point_groups.rst b/docs/points/point_groups.rst index 233606e5..ab2acad3 100644 --- a/docs/points/point_groups.rst +++ b/docs/points/point_groups.rst @@ -5,10 +5,15 @@ Point Groups .. vale on -Point Groups is a feature that allows users to categorize the score of their Contacts. By setting up Point Groups, users can assign a specific number of Points to each action taken by a Contact, such as opening an Email, visiting a Landing page, or downloading an Asset. +Point Groups is a feature that allows Users to categorize the score of their Contacts. By setting up Point Groups, Users can assign a specific number of Points to each action taken by a Contact, such as opening an Email, visiting a Landing Page, or downloading an Asset. + +.. vale off Managing Point Groups ====================== + +.. vale on + To access the currently defined Point Groups in Mautic, navigate to the Points Menu and click the "Manage Groups" link. To create a new Group, simply click the "New" button. .. image:: images/new-group.png @@ -17,20 +22,30 @@ To access the currently defined Point Groups in Mautic, navigate to the Points M Enter a name and a description for the Group and click the "Save & Close" button to create the Group. +.. vale off + Point Groups usage =================== -Point actions +Point Actions ------------- + +.. vale on + You can change Contact's Points within a Points Group by using Points Actions. .. image:: images/point-action-with-group.png :width: 600 :alt: Screenshot of Points action with Group -Point triggers +.. vale off + +Point Triggers -------------- -You can use Point triggers based on Point Groups to automatically trigger specific events within the system. + +.. vale on + +You can use Point Triggers based on Point Groups to automatically trigger specific events within the system. .. image:: images/point-trigger-with-group.png :width: 600 @@ -58,11 +73,11 @@ You can use a Form action to increase or decrease the Group Contact score. .. image:: images/form-action-with-point-group.png :width: 600 - :alt: Screenshot of Form Adjust contact's points action with Group + :alt: Screenshot of Form Adjust Contact's Points Action with Group Segment filters --------------- -Each Point Group adds a new filter that can be used to configurate the Segment. +Each Point Group adds a new filter for configuring the Segment. .. image:: images/segment-group-filter.png :width: 600 @@ -80,8 +95,13 @@ You can display Point Groups in the Contact details. :width: 600 :alt: Screenshot of Contact Details with Group Points +.. vale off + Group Report ------------- + +.. vale on + You can generate a Report that contains information about Contact Point Groups. .. image:: images/group-report.png @@ -90,4 +110,4 @@ You can generate a Report that contains information about Contact Point Groups. Webhooks -------- -Changing the Contact Group Points will not trigger the Contact Points Changed Event Webhook \ No newline at end of file +Changing the Contact Group Points doesn't trigger the Contact Points Changed Event Webhook \ No newline at end of file From b6f338133ec79d122fdeed4ee578c9eb1b95ecb7 Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Fri, 22 Dec 2023 15:53:16 +0000 Subject: [PATCH 29/46] Assets --- docs/components/assets.rst | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/docs/components/assets.rst b/docs/components/assets.rst index 3525d825..7d61fcdd 100644 --- a/docs/components/assets.rst +++ b/docs/components/assets.rst @@ -35,8 +35,13 @@ Navigate to Components > Assets. Mautic lists any Assets you have previously cre You create Assets by uploading local resources on your computer, or by locating the Asset from a remote storage host such as Amazon S3. There are limitations by size due to the settings of your server - any such restriction may display as a warning message in the file upload section. -Add UTM to Asset -~~~~~~~~~~~~~~~~~~ +.. vale off + +Add UTM codes to Asset +~~~~~~~~~~~~~~~~~~~~~~ + +.. vale on + UTM parameters appended to the download link means that UTM data is available in the resource download Report. .. code-block:: php @@ -82,7 +87,7 @@ The following fields are available: .. vale on -- **Block search engines from indexing this file** - If you don't want to index files like PDF, DOCx and so forth, setting this switch to Yes sends the X-Robots-Tag no-index http header. If set to No, the header isn't sent and your files could become indexed by search engines. +- **Block search engines from indexing this file** - If you don't want to index files like ``PDF``, ``DOCx`` and so forth, setting this switch to Yes sends the ``X-Robots-Tag no-index`` HTTP header. If set to No, the header isn't sent and your files could become indexed by search engines. Depending on the type of file uploaded, a preview may display after the upload completes. @@ -108,7 +113,7 @@ Viewing an Asset Once you've uploaded an Asset, you'll want to make it available for your Contacts to access it. Using the Download URL from the Asset section in Mautic, you can track which Contacts are downloading or viewing the Assets. -Copy and paste the link into your website, on a landing page, or as a link in an Email. +Copy and paste the link into your website, on a Landing Page, or as a link in an Email. .. note:: In a Mautic Email or Landing Page, append ``?stream=1`` to the end of the URL to open the Asset in a new tab. From 6b39351ca7a737d52790338ed38b7d6eafb2b1d1 Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Fri, 22 Dec 2023 15:53:52 +0000 Subject: [PATCH 30/46] Points troubleshooting --- docs/points/points_troubleshooting.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/points/points_troubleshooting.rst b/docs/points/points_troubleshooting.rst index 0f2dc084..ea10fb1c 100644 --- a/docs/points/points_troubleshooting.rst +++ b/docs/points/points_troubleshooting.rst @@ -8,7 +8,7 @@ To workaround this issue, try one of the following options: 1. Make sure that you aren't testing while logged into Mautic. Mautic ignores activity from Mautic Administrators. So, it's suggested that you use an anonymous session, an incognito window, another browser, or log out of Mautic. -2. The tracking of Point actions is currently done once per Contact. This means that subsequent visits won't re-trigger the action if already triggered once. +2. The tracking of Point Actions is currently done once per Contact. This means that subsequent visits won't re-trigger the action if already triggered once. 3. Ensure that the URL defined either matches exactly the URL visited or use a wildcard. A URL can include the schema, host/domain, path, query parameters, and/or fragment. From 2e30cd6084874e7a225bafe7831234f84eafdecb Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Fri, 22 Dec 2023 16:32:46 +0000 Subject: [PATCH 31/46] Dashboard --- docs/dashboard/dashboard.rst | 56 ++++++++++++++++++++++-------------- 1 file changed, 34 insertions(+), 22 deletions(-) diff --git a/docs/dashboard/dashboard.rst b/docs/dashboard/dashboard.rst index 188788cf..7e7a3a4a 100644 --- a/docs/dashboard/dashboard.rst +++ b/docs/dashboard/dashboard.rst @@ -6,15 +6,19 @@ Mautic 1.4.0 introduced a customizable dashboard where each User can compose wid Date range filter ***************** -All the widgets will display data in the selected global date range filter at the top of the widget list. The default date range is set from 30 days ago to today. +All the widgets display data in the selected global date range filter at the top of the widget list. Mautic sets the default date range from 30 days ago to today. .. image:: images/dashboard-date-filters.png :width: 600 :alt: Screenshot of Dashboard date filter -Line charts will change the time unit automatically depending on the day count selected in the date range filter like this: +Line charts change the time unit automatically depending on the day count selected in the date range filter like this: -Date range is equal 1 day: data will be displayed in hours Date range is between 1 and 31 days: data will be displayed in days Date range is between 32 and 100 days: data will be displayed in weeks Date range is between 101 and 1000 days: data will be displayed in months Date range is greater than 1001 days: data will be displayed in years +**Date range is equal 1 day:** data displays in hours +**Date range is between 1 and 31 days:** data displays in days +**Date range is between 32 and 100 days:** data displays in weeks +**Date range is between 101 and 1000 days:** data displays in months +**Date range is greater than 1001 days:** data displays in years The only widget exceptions which display the same information independent on the date range are *Upcoming Emails* and *Recent activity*. @@ -25,15 +29,15 @@ Widgets Don't create too many widgets. It can slow the dashboard Landing Page load down. If you have performance issues, decrease the amount of widgets. -A new widget can be added to your dashboard when you click the "Add widget" button. The "Add widget" Form which appears after each widget will let you define: +You can add a new widget to your dashboard when you click the "Add widget" button. The "Add widget" Form which appears after each widget allows you define: -- **Name:** describe what the widget displays. If not filled, Mautic will call it the same as the widget type you select. +- **Name:** describe what the widget displays. If not filled, Mautic calls it the same as the widget type you select. - **Type:** select what information you want to display from the predefined widget types. - **Width:** select how wide the widget should be. The options are 25%, 50%, 75%, 100%. The default option is 100%. The optimal width for line charts is 100%, for tables 50%, for pie charts 25%. -- **Height:** each widget can have different height. 5 heights are predefined. The dashboard will look best if you select a consistent height for each widget in the same row. +- **Height:** each widget can have different height. There are 5 heights predefined. The dashboard looks best if you select a consistent height for each widget in the same row. Some widgets have additional options: @@ -47,21 +51,21 @@ Some widgets have additional options: - All identified vs anonymous: displays 2 lines with anonymous visitors and known Contacts. -- Top Segments: displays up to 6 lines representing the number of Contacts added to the top 6 Segments. If no such Segment exists for the selected date range, the chart won't be displayed. +- Top Segments: displays up to 6 lines representing the number of Contacts added to the top 6 Segments. If no such Segment exists for the selected date range, the chart won't display. -- Top Segments with Identified vs Anonymous: displays up to 6 lines representing the top 3 Segments for the selected date range. Each Segment will show 2 lines with anonymous visitors and known Contacts. +- Top Segments with Identified vs Anonymous: displays up to 6 lines representing the top 3 Segments for the selected date range. Each Segment shows 2 lines with anonymous visitors and known Contacts. **Emails in time** -- Only sent Emails: Displays 1 line with sent Emails. +- Only sent Email - Displays 1 line with sent Emails. -- Only opened Emails: Displays 1 line with opened Emails. +- Only opened Emails - Displays 1 line with opened Emails. -- Only failed Emails: Displays 1 line with failed Emails. +- Only failed Emails - Displays 1 line with failed Emails. -- Sent and opened Emails: Displays 2 lines with sent and opened Emails. +- Sent and opened Emails - Displays 2 lines with sent and opened Emails. -- Sent, opened and failed Emails: Displays 3 lines with sent, opened and failed Emails. +- Sent, opened and failed Emails - Displays 3 lines with sent, opened and failed Emails. **Landing Page visits in time** @@ -74,38 +78,46 @@ Some widgets have additional options: Widget ordering *************** -Each widget can be moved on the dashboard using the drag and drop interface. Click and hold on the name of the widget to move it to another position. +You can move each widget can on the dashboard using the drag and drop interface. Click and hold on the name of the widget to move it to another position. Dashboard export **************** -Each dashboard, once configured, can be exported to a single file and shared with others. You can make a backup, send it to a colleague or share it online. It exports only the widget configuration - the data which it pulls is not included in the exported file. +Each dashboard, once configured, is exportable to a single file and shared with others. You can make a backup, send it to a colleague or share it online. It exports only the widget configuration - the data which it pulls isn't included in the exported file. Dashboard import **************** If you export a dashboard, you can then upload it and import it again in the Dashboard Import page. -Mautic installation come pre-loaded with 3 pre-defined dashboards. The one called default.json is imported automatically, when your dashboard doesn't contain any widgets. The other 2 predefined dashboards are provided as an example. You can export and import any other dashboards and switch between them. Pre-defined dashboards can be: +Mautic installations come pre-loaded with 3 pre-defined dashboards. Mautic imports the one called default.json automatically, when your dashboard doesn't contain any widgets. The other 2 predefined dashboards provide an example of alternate layouts. You can export and import any other dashboards and switch between them. -Previewed - This will display the dashboard widgets for preview. The dashboard will be loaded using your existing Mautic data. Nothing is saved or changed. Applied - This sets the dashboard as your primary dashboard. +Pre-defined dashboards can be: + +**Previewed** - This displays the dashboard widgets for preview. The dashboard loads using your existing Mautic dat but doesn't save or change anything. + +**Applied** - This sets the dashboard as your primary dashboard. .. warning:: - Your current widgets will be deleted by this action. Export the current dashboard if you want to go back to it later. Deleted - This will delete the predefined dashboard. + This deletes your current widgets. Export the current dashboard if you want to go back to it later. + +**Deleted** - This deletes the predefined dashboard. Widget cache ************ -The WidgetDetailEvent automatically caches the widget detail data for a period of time defined in the configuration. The default cache expiration period is 10 minutes. +The ``WidgetDetailEvent`` automatically caches the widget detail data for a period of time defined in the configuration. The default cache expiration period is 10 minutes. -Dashboard Permissions +Dashboard permissions ********************* If a Mautic User doesn't have the 'see others' or 'see own' permissions for a bundle, they won't be able to create widgets for that bundle. However, the widget can still be visible on their dashboard. + For example if a User creates the widgets and then the administrator removes the permission for that bundle, or if a User imports a dashboard which has widgets for bundles they're not permitted to access. -In these cases, the widget is displayed on the dashboard, but with a message that the User doesn't have permission to see the data. -If a Mautic User has permission to see only their own data from a bundle, they will see only their own data in the Dashboard widgets. For example only Contacts which they own, Landing Page hits of the Landing Pages they created and so on. +In these cases, Mautic displays the widget on the dashboard, but with a message that the User doesn't have permission to see the data. + +If a Mautic User has permission to see only their own data from a bundle, they see only their own data in the Dashboard widgets. For example only Contacts which they own, Landing Page hits of the Landing Pages they created and so on. From 0ded084a2a9627bbb797d4095a901670a244351e Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Fri, 22 Dec 2023 16:33:32 +0000 Subject: [PATCH 32/46] Dynamic Content --- docs/components/dynamic_web_content.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/components/dynamic_web_content.rst b/docs/components/dynamic_web_content.rst index e80552fc..4307b08c 100644 --- a/docs/components/dynamic_web_content.rst +++ b/docs/components/dynamic_web_content.rst @@ -107,11 +107,11 @@ Campaign-based Dynamic Web Content Creating the request ==================== -Use a Campaign Decision for ``Request Dynamic Content`` to use Campaign-based dynamic content. The Campaign Decision checks if a Campaign member visits a page where a Dynamic Content slot is. Visitors to a page with a Dynamic Content slot receive the Dynamic Content. +Use a Campaign Decision for ``Request Dynamic Content`` to use Campaign-based Dynamic Content. The Campaign Decision checks if a Campaign member visits a page where a Dynamic Content slot is. Visitors to a page with a Dynamic Content slot receive the Dynamic Content. The following fields are available: -- **Name** - the Campaign event. Start the name with something like Req-DWC: so when you're looking at Campaign Reports, you can see the event type. +- **Name** - the Campaign event. Start the name with something like ``Req-DWC``: so when you're looking at Campaign Reports, you can see the event type. - **Requested Slot Name** - Mautic checks for the slot name. You can see how many Contacts got to the Campaign event where you're checking if their visits request the slot. From 2aa95a04bd1534db436e23c04004ec7fb58121aa Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Fri, 22 Dec 2023 16:35:35 +0000 Subject: [PATCH 33/46] Marketplace --- docs/marketplace/marketplace.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/marketplace/marketplace.rst b/docs/marketplace/marketplace.rst index 0ca006a8..11b289df 100644 --- a/docs/marketplace/marketplace.rst +++ b/docs/marketplace/marketplace.rst @@ -84,7 +84,7 @@ From the list you can see Plugin versions, and the release cadence. When you cli Maintainers =========== -In this section is a list of maintainers of the Plugin on Packagist. There may be more contributors in the GitHub repository. There is also a link to the maintainer's Packagist detail page where you can browse other PHP packages by the same maintainer. +In this section is a list of maintainers of the Plugin on Packagist. There may be more contributors in the GitHub repository. There is also a link to the Packagist detail page for the maintainer, where you can browse other PHP packages by the same maintainer. GitHub information ================== From c5c97bdda029ce23cf969e2db11b64c39d434fca Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Fri, 22 Dec 2023 16:35:44 +0000 Subject: [PATCH 34/46] landing pages --- docs/components/landing_pages.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/components/landing_pages.rst b/docs/components/landing_pages.rst index 801e05b6..75f9a6f9 100644 --- a/docs/components/landing_pages.rst +++ b/docs/components/landing_pages.rst @@ -1,8 +1,8 @@ -.. vale off - Landing Pages ############# +.. vale off + Customizing the Preference Center ********************************* From ac053d1ec4a31b804ee6592b6fc47865d49440dc Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Fri, 22 Dec 2023 16:36:35 +0000 Subject: [PATCH 35/46] Search operators --- docs/search/search_operators.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/search/search_operators.rst b/docs/search/search_operators.rst index 7ba807ff..1d2f923f 100644 --- a/docs/search/search_operators.rst +++ b/docs/search/search_operators.rst @@ -169,7 +169,7 @@ Emails search filters category:{category alias} lang:{lang code} -Focus items search filters +Focus Items search filters -------------------------- .. code-block:: From 0980831c2d49e515a3afc11bc6b279f175a5884b Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Fri, 22 Dec 2023 16:38:21 +0000 Subject: [PATCH 36/46] Roles --- docs/users_roles/managing_roles.rst | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/docs/users_roles/managing_roles.rst b/docs/users_roles/managing_roles.rst index cd761116..2299e432 100644 --- a/docs/users_roles/managing_roles.rst +++ b/docs/users_roles/managing_roles.rst @@ -1,10 +1,6 @@ -.. vale off - Roles ##### -.. vale on - You can control access to Mautic instances by creating accounts for Users and associating them with a Role. :doc:`Users` are the accounts an individual uses to access Mautic, whereas :ref:`Roles` allow or deny access to various features within Mautic. @@ -88,7 +84,7 @@ There are permission levels relating to resources the User has created themselve There are permission levels relating to being able to manage resources: -* **Manage** - this allows the Users with this Role to manage resources in this area of Mautic for example, managing custom fields or Plugins. +* **Manage** - this allows the Users with this Role to manage resources in this area of Mautic for example, managing Custom Fields or Plugins. There are permission levels relating to the editable fields in the Users section: From ec912bd1ed4058ac233d9925773700161105ca74 Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Fri, 22 Dec 2023 16:39:37 +0000 Subject: [PATCH 37/46] Contacts overview --- docs/contacts/contacts_overview.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/contacts/contacts_overview.rst b/docs/contacts/contacts_overview.rst index 0047c22b..b26fb395 100644 --- a/docs/contacts/contacts_overview.rst +++ b/docs/contacts/contacts_overview.rst @@ -12,8 +12,8 @@ Contact types There are two types of Contacts: -Visitors (formerly anonymous leads) -=================================== +Visitors - formerly ``anonymous leads`` +======================================= Unidentified visitors to your site who haven't yet completed a Form or otherwise interacted with your site. @@ -37,7 +37,7 @@ If you have an IP lookup service :ref:`configured` in ** * Scoring -* Data from Forms - which don't include the unique identifier, since that would make the contact known +* Data from Forms - which don't include the unique identifier, since that would make the Contact known .. note:: From ebede17d156d3d02dd73ee96bf4f4c7482f46898 Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Fri, 22 Dec 2023 16:42:22 +0000 Subject: [PATCH 38/46] Import contacts --- docs/contacts/import_contacts.rst | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) diff --git a/docs/contacts/import_contacts.rst b/docs/contacts/import_contacts.rst index db74ad97..b44d7c1d 100644 --- a/docs/contacts/import_contacts.rst +++ b/docs/contacts/import_contacts.rst @@ -1,10 +1,6 @@ -.. vale off - Import Contacts ############### -.. vale on - Contact importing is possible through the User Interface in Mautic. For larger imports it's recommended to complete the import in the background via a cron job. Since Mautic 2.9, Mautic shows in a Contact's event history when an import job creates or updates a Contact. @@ -197,11 +193,11 @@ When the background job finishes, either successfully or if it fails, you'll get FAQ *** -Q. The import times out. +Q. The import times out, what should you do? A. Either use the background job to import, or change the batch limit to smaller number than 100. -Q: Are imported *Do Not Contact* values stored as a bounce or a ``unsubscription``? +Q. What happens with imported *Do Not Contact* values? Are they stored as a bounce or a ``unsubscription``? A. It's stored as a ``Manual Unsubscription``. It's the same as marking the Contact *Do Not Contact* from the Contact's page. From 8b07dd1e9591ff3d869a900cf2fbbdb6b9f44a3a Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Fri, 22 Dec 2023 16:43:56 +0000 Subject: [PATCH 39/46] Custom fields --- docs/contacts/custom_fields.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/contacts/custom_fields.rst b/docs/contacts/custom_fields.rst index 9739a636..06d4bf98 100644 --- a/docs/contacts/custom_fields.rst +++ b/docs/contacts/custom_fields.rst @@ -35,7 +35,7 @@ You'll notice the group column shows the specific field on the Contact profile. 2. **List icon** - You can use these fields as filters for Segments. -3. **Asterisks icon** - These fields are required when filling in the Contact Form +3. **Asterisks icon** - These are mandatory when filling in the Contact Form 4. **Globe icon** - You can update these fields publicly through the :doc:`tracking pixel` URL query see :doc:`Contact Monitoring` for more details. @@ -83,7 +83,7 @@ Adding a new Custom Field .. vale on -You can create additional custom fields and define the data type you want that field to hold. In addition to the data type you select the group for that particular field. This defines where the field displays on the Contact edit and detail view. +You can create additional Custom Fields and define the data type you want that field to hold. In addition to the data type you select the group for that particular field. This defines where the field displays on the Contact edit and detail view. .. image:: images/new-custom-field.jpeg :align: center @@ -100,7 +100,7 @@ There is a way around this when you configure the processing of field creation i Since :xref:`Mautic 3` there is an option you can set in your ``app/config/local.php`` file: ``'create_custom_field_in_background' => true``,. -If you configure this option, the new Custom Field becomes visible in the list of Custom Fields. The custom field remains unpublished until you run the command ``bin/console mautic:custom-field:create-column``. This command creates the actual column in the table and publishes the field metadata. +If you configure this option, the new Custom Field becomes visible in the list of Custom Fields. The Custom Field remains unpublished until you run the command ``bin/console mautic:custom-field:create-column``. This command creates the actual column in the table and publishes the field metadata. This configuration helps prevent **http** request timeouts because it handles the long-running SQL query to create the new table column as a background task. From 8d5cd0828bdb9745d725ffe75ff258c1f0f52d3a Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Fri, 22 Dec 2023 16:46:11 +0000 Subject: [PATCH 40/46] Twilio --- docs/plugins/twilio.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/plugins/twilio.rst b/docs/plugins/twilio.rst index 96a7bf5d..5f6a8372 100644 --- a/docs/plugins/twilio.rst +++ b/docs/plugins/twilio.rst @@ -60,21 +60,21 @@ You can verify if your account has Alphanumeric Sender enabled by following thes #. Click Settings. -#. Verify that "Alphanumeric Sender ID" is set to Enabled. +#. Verify that you have ``Alphanumeric Sender ID``. Follow these steps to see if your account has Alphanumeric Sender enabled. -.. vale on +.. vale off Send SMS Messages using an Alphanumeric Sender ID with Mautic ************************************************************* -.. vale off +.. vale on -Just setup your alias in plugin settings: +Just set up your alias in Plugin settings: .. image:: images/alphanumeric-id.png :width: 400 :alt: Screenshot of alphanumeric-id -Read more info about :xref:`Alphanumeric Sender ID` on Twillio site. \ No newline at end of file +Read more info about :xref:`Alphanumeric Sender ID` on Twilio site. \ No newline at end of file From cf2c8de9c6a1708e915adcdc0de8438791a1e6c2 Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Fri, 22 Dec 2023 16:46:49 +0000 Subject: [PATCH 41/46] Cron jobs --- .github/styles/Vocab/Mautic/accept.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/.github/styles/Vocab/Mautic/accept.txt b/.github/styles/Vocab/Mautic/accept.txt index 8fd7465e..cbb0be41 100644 --- a/.github/styles/Vocab/Mautic/accept.txt +++ b/.github/styles/Vocab/Mautic/accept.txt @@ -27,6 +27,7 @@ configurator ConnectWise Contribution(s) CORS +cPanel CRM cron Cron From b89fbdc7cff6f10f5315811f0f1017bccc21ace8 Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Fri, 22 Dec 2023 16:47:11 +0000 Subject: [PATCH 42/46] iContact --- .github/styles/Vocab/Mautic/accept.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/.github/styles/Vocab/Mautic/accept.txt b/.github/styles/Vocab/Mautic/accept.txt index cbb0be41..b6ece7aa 100644 --- a/.github/styles/Vocab/Mautic/accept.txt +++ b/.github/styles/Vocab/Mautic/accept.txt @@ -59,6 +59,7 @@ HTML http https HubSpot +iContact IDP IMAP IPs From 76373632aab58844e48904cae8fd854eed270df6 Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Fri, 22 Dec 2023 16:47:30 +0000 Subject: [PATCH 43/46] Mailchimp --- .github/styles/Vocab/Mautic/accept.txt | 1 + 1 file changed, 1 insertion(+) diff --git a/.github/styles/Vocab/Mautic/accept.txt b/.github/styles/Vocab/Mautic/accept.txt index b6ece7aa..f0d19eb1 100644 --- a/.github/styles/Vocab/Mautic/accept.txt +++ b/.github/styles/Vocab/Mautic/accept.txt @@ -70,6 +70,7 @@ Joomla! Libre Licensor LinkedIn +MailChimp Mailjet Marketing Messages Mautic From 5df2625845f94ba1418840d6ab7a1de93237fd5d Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Fri, 22 Dec 2023 16:48:59 +0000 Subject: [PATCH 44/46] Creating themes --- docs/builders/creating_themes.rst | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) diff --git a/docs/builders/creating_themes.rst b/docs/builders/creating_themes.rst index adfb731e..d1c8587e 100644 --- a/docs/builders/creating_themes.rst +++ b/docs/builders/creating_themes.rst @@ -1,10 +1,6 @@ -.. vale off - Creating Themes ############### -.. vale on - :xref:`MJML` allows marketers to create and maintain beautiful and responsive Themes for Mautic easily. .. vale off @@ -127,11 +123,11 @@ File structure Steps to save the Theme package =============================== -Once your design in MJML is finalized, go through the following steps to create the Theme package: +Once you have finalized you design in MJML, go through the following steps to create the Theme package: * Save your images in the Assets folder. -* Save your MJML in the ``html`` folder as ``email.mjml.twig`` AND ``email.html.twig``. +* Save your MJML in the ``html`` folder as ``email.mjml.twig`` **and** ``email.html.twig``. * Use the ``base.html.twig`` and ``message.html.twig`` files from the basic Theme or make your changes there. From eaeee51cf2f35f22b799b9ecaa76a14e6a041841 Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Fri, 22 Dec 2023 17:54:14 +0000 Subject: [PATCH 45/46] Fix typo --- docs/builders/creating_themes.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/builders/creating_themes.rst b/docs/builders/creating_themes.rst index d1c8587e..00cd768f 100644 --- a/docs/builders/creating_themes.rst +++ b/docs/builders/creating_themes.rst @@ -123,7 +123,7 @@ File structure Steps to save the Theme package =============================== -Once you have finalized you design in MJML, go through the following steps to create the Theme package: +Once you have finalized your design in MJML, go through the following steps to create the Theme package: * Save your images in the Assets folder. @@ -135,4 +135,4 @@ Once you have finalized you design in MJML, go through the following steps to cr * Create a thumbnail - use the dimensions of 400px wide, 600px high. -* Compress the contents of the folder as a Zip file - ensure that the files and folders aren't within a sub-folder in the Zip file. \ No newline at end of file +* Compress the contents of the folder as a Zip file - ensure that the files and folders aren't within a sub-folder in the Zip file. From 77e6c2950da5c9f75ec1c9ccb60f1f8929694196 Mon Sep 17 00:00:00 2001 From: Ruth Cheesley Date: Tue, 9 Jan 2024 17:35:50 +0000 Subject: [PATCH 46/46] Fix incorrect Vale warnings --- docs/configuration/settings.rst | 3 +++ docs/getting_started/how_to_update_mautic.rst | 6 +++++- docs/getting_started/switching_composer.rst | 5 +++++ 3 files changed, 13 insertions(+), 1 deletion(-) diff --git a/docs/configuration/settings.rst b/docs/configuration/settings.rst index 686dba29..64d0f4e6 100644 --- a/docs/configuration/settings.rst +++ b/docs/configuration/settings.rst @@ -252,6 +252,8 @@ To replace the SendGrid API key, add it to the relevant field in the Email confi The table below lists available transport Plugins created for Mautic to include support for batch sending and callback handling. +.. vale off + .. list-table:: :widths: 40 60 :header-rows: 1 @@ -260,6 +262,7 @@ The table below lists available transport Plugins created for Mautic to include - Command for installing * - :xref:`sparkpost-transport` - ``composer require ts-navghane/sparkpost-plugin`` +.. vale on Queue settings ============== diff --git a/docs/getting_started/how_to_update_mautic.rst b/docs/getting_started/how_to_update_mautic.rst index a4ffec5e..6e493fca 100644 --- a/docs/getting_started/how_to_update_mautic.rst +++ b/docs/getting_started/how_to_update_mautic.rst @@ -138,4 +138,8 @@ In all cases, it's important to provide details about the issue, as well as the If you don't provide the information requested as a minimum, the person who might try to help you has to ask you for it, so please save them the trouble and provide the information upfront. Also, importantly, please be polite. Mautic is an open source project, and people are giving their free time to help you. -If you are sure that you have discovered a bug and you want to report it to developers, you can :xref:`Mautic Github New Issue` on GitHub. GitHub isn't the right place to request support or ask for help with configuration errors. Always post on the forums first if you aren't sure, if a bug report is appropriate this can link to the forum thread. \ No newline at end of file +.. vale off + +If you are sure that you have discovered a bug and you want to report it to developers, you can :xref:`Mautic Github New Issue` on GitHub. GitHub isn't the right place to request support or ask for help with configuration errors. Always post on the forums first if you aren't sure, if a bug report is appropriate this can link to the forum thread. + +.. vale on diff --git a/docs/getting_started/switching_composer.rst b/docs/getting_started/switching_composer.rst index ccafb4bb..110958b5 100644 --- a/docs/getting_started/switching_composer.rst +++ b/docs/getting_started/switching_composer.rst @@ -10,8 +10,13 @@ However, many Mautic Users were running into installation and update errors, man In addition, Mautic recently introduced the :ref:`Mautic Marketplace` which isn't compatible with this installation method. + +.. vale off + As a result of the reasons mentioned previously, Composer becomes the default method for installing and updating Mautic starting with the release of Mautic 5. Read more in the :xref:`composer blog post`. +.. vale on + Switching to a Composer-based installation ******************************************