GitXplorerGitXplorer
d

vue-email-personaliser

public
3 stars
0 forks
0 issues

Commits

List of commits on branch master.
Unverified
109fb5559b1afcd0cd37ee5fccc43b41abf74b86

Improve README

ddamms005 committed 4 years ago
Unverified
bf138e4a8f17df674a3d67534496bc9366ff4490

0.9.4

ddamms005 committed 4 years ago
Unverified
e8a020168aa44b34a906a818a92e21305800d4d6

Use Vue refs for referencing editor

ddamms005 committed 4 years ago
Unverified
78cdbf859601c37a630c24a94a8a952999d05836

0.9.3

ddamms005 committed 4 years ago
Unverified
3abc2515e004d995771cd5ce69f7f43c07221eb8

Fix early Vue update

ddamms005 committed 4 years ago
Unverified
3b34ec2980bc4fa0493ff01c7732d0db0ab731a9

0.9.2

ddamms005 committed 4 years ago

README

The README file for this repository.

vue-email-personaliser

Art for vue-email-personaliser

Vue Web Component for formatting email message based on CSV file content). Sample backend (Laravel package): laravel-personalised-email-sender

The general workflow in using this Vue component is:

  • Paste details of your email recipients in CSV format (actually, TSV, for now :)). The first row are parsed as header/placeholders
  • Format the email you wish to send (use {{mustache}} syntax to dynamically inject data from the CSV pasted above. The CSV headers serve as placeholders)
  • Check the rendered sample email message in the Preview box to be sure your formatted mail looks the way you want it
  • Specify your backend endpoint that handles the actual sending of the email messages (see sample implementation here. You can actually simply use laravel-personalised-email-sender) as your backend end-point
  • Specify the index of the column that your endpoint will uniquely use to identify each row
  • Send it!

Usage

As a web browser drop-in Vue component

The /dist folder contains this package's Vue Web Component built with the --inline-vue flag (see more details in the package.json file). This means that you can immediately start using this package as a Vue component by simply importing it into your web page like below:

<script src='dist/vue-email-personaliser.min.js'></script>

This will provide you with a Vue component as <vue-email-personaliser></vue-email-personaliser>. This component accepts a prop named default-post-endpoint, which you use to specify the endpoint that will do the actual sending out of your email (e.g. as implemented in laravel-personalised-email-sender). The formatted email template will be POSTed to this endpoint.

Development

If you are interested in having a dev version of this project (e.g. for customization), cd to the project root and run the following commands:

npm install

Compiles and hot-reloads for development

npm run serve

Compiles and minifies for production

npm run build

Run your tests

npm run test

Lints and fixes files

npm run lint

Customize configuration

See Configuration Reference.

Todo

  • Write tests
  • Improve README to have more practical example (screenshot?)

Learning resources