<commit_before># Mosaico - Responsive email template editor

This extension integrates a responsive email template editor, [Mosaico](https://mosaico.io/), with CiviCRM.

View/Download this extension in the [Extension Directory](https://civicrm.org/extensions/email-template-builder).

## Compatibility / Requirements
* CiviCRM 5.13+
* PHP-ImageMagick - recommended.
* [FlexMailer](https://docs.civicrm.org/flexmailer/en/latest/) 1.1+ 

## History and blog posts
 * [Initial Blog Post](https://civicrm.org/blogs/parvez/a-new-beginning-for-civimail)
 * [Beta Blog Post](https://civicrm.org/blog/deepaksrivastava/email-template-builder-civimosaico-is-now-beta)
 * [Initial Video](https://vimeo.com/156633077)
 * [v1.0 Stable Release](https://github.com/veda-consulting/uk.co.vedaconsulting.mosaico/releases/tag/1.0)
 * [v2.0 Plans](https://civicrm.org/blog/jamienovick/email-template-builder-mosaico-phase-2-plans)
 * [v2.0 and Styling Blog Post](https://civicrm.org/blog/jamienovick/extreme-makeovers-civicrm-style-introducing-the-shoreditch-theme-civicrms-new-user)

### Using with Scheduled reminders, personal messages etc

An experimental extension is available here: https://github.com/civicrm/org.civicrm.mosaicomsgtpl

## Installation

See: https://docs.civicrm.org/sysadmin/en/latest/customize/extensions/#installing-a-new-extension

**DO NOT DOWNLOAD DIRECTLY FROM GITHUB**: 
Download via https://civicrm.org/extensions/email-template-builder as there are additional packaging requirements not handled by github.

## Getting started (Usage)

If you haven't used Mosaico before, consult the the demo and tutorial materials from [Mosaico.io](https://mosaico.io/index.html).

To send a new mailing, simply navigate to *Mailings > New Mailing*. The CiviMail-Mosaico UI should appear.

Optionally, you may design reusable templates by navigating to *Mailings > Mosaico Templates*.

When composing a new mailing with Mosaico, the screen may be configured as a three-step wizard or as a single-step form. To
choose a layout, navigate to *Administer > CiviMail > Mosaico Settings*.

If you would like to compose mailings with the *old* CiviMail screen, navigate to *Mailings > New Mailing (Traditional)*.

## Support and Maintenance

This extension is supported and maintained by the CiviCRM community.

Please make sure you have followed installation instructions.

Open issues on [github](https://github.com/veda-consulting/uk.co.vedaconsulting.mosaico/issues) with:
- screenshot of failure with any possible errors in firebug or js console
- any related logs or backtrace from civicrm
- tell us what version of CiviCRM and extension, you using.
- tell us the browser you are using (name and version) and test at least a second browser to tell us if this happen in both or only one (tell us the details about the second browser too).

## Migration to a new Domain

If you move CiviCRM to a new domain, you must update the template paths in the CiviCRM database with a MySQL query such as:
```
UPDATE civicrm_mosaico_template SET metadata = replace(metadata, 'old-domain.org', 'new-domain.org');
```<commit_msg>Replace MySQL query to update URLs with new API call<commit_after># Mosaico - Responsive email template editor

This extension integrates a responsive email template editor, [Mosaico](https://mosaico.io/), with CiviCRM.

View/Download this extension in the [Extension Directory](https://civicrm.org/extensions/email-template-builder).

## Compatibility / Requirements
* CiviCRM 5.13+
* PHP-ImageMagick - recommended.
* [FlexMailer](https://docs.civicrm.org/flexmailer/en/latest/) 1.1+ 

## History and blog posts
 * [Initial Blog Post](https://civicrm.org/blogs/parvez/a-new-beginning-for-civimail)
 * [Beta Blog Post](https://civicrm.org/blog/deepaksrivastava/email-template-builder-civimosaico-is-now-beta)
 * [Initial Video](https://vimeo.com/156633077)
 * [v1.0 Stable Release](https://github.com/veda-consulting/uk.co.vedaconsulting.mosaico/releases/tag/1.0)
 * [v2.0 Plans](https://civicrm.org/blog/jamienovick/email-template-builder-mosaico-phase-2-plans)
 * [v2.0 and Styling Blog Post](https://civicrm.org/blog/jamienovick/extreme-makeovers-civicrm-style-introducing-the-shoreditch-theme-civicrms-new-user)

### Using with Scheduled reminders, personal messages etc

An experimental extension is available here: https://github.com/civicrm/org.civicrm.mosaicomsgtpl

## Installation

See: https://docs.civicrm.org/sysadmin/en/latest/customize/extensions/#installing-a-new-extension

**DO NOT DOWNLOAD DIRECTLY FROM GITHUB**: 
Download via https://civicrm.org/extensions/email-template-builder as there are additional packaging requirements not handled by github.

## Getting started (Usage)

If you haven't used Mosaico before, consult the the demo and tutorial materials from [Mosaico.io](https://mosaico.io/index.html).

To send a new mailing, simply navigate to *Mailings > New Mailing*. The CiviMail-Mosaico UI should appear.

Optionally, you may design reusable templates by navigating to *Mailings > Mosaico Templates*.

When composing a new mailing with Mosaico, the screen may be configured as a three-step wizard or as a single-step form. To
choose a layout, navigate to *Administer > CiviMail > Mosaico Settings*.

If you would like to compose mailings with the *old* CiviMail screen, navigate to *Mailings > New Mailing (Traditional)*.

## Support and Maintenance

This extension is supported and maintained by the CiviCRM community.

Please make sure you have followed installation instructions.

Open issues on [github](https://github.com/veda-consulting/uk.co.vedaconsulting.mosaico/issues) with:
- screenshot of failure with any possible errors in firebug or js console
- any related logs or backtrace from civicrm
- tell us what version of CiviCRM and extension, you using.
- tell us the browser you are using (name and version) and test at least a second browser to tell us if this happen in both or only one (tell us the details about the second browser too).

## Migration to a new Domain

If you move CiviCRM to a new domain, you must update the template paths using the `replaceurls` API method:

```
cv api MosaicoTemplate.replaceurls from_url="http://old.server.org" to_url="https://new.server.org"
```
{'fraction_non_alphanumeric': 0.10137732222934016, 'fraction_numerical': 0.007367072389493914, 'mean_word_length': 4.771719038817006, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 13, 'https://': 29, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 4, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '3545211', 'n_tokens_mistral': 1997, 'n_tokens_neox': 1902, 'n_words': 628}