Download the PHP package moirei/custom-email-sender without Composer
On this page you can find all versions of the php package moirei/custom-email-sender. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download moirei/custom-email-sender
More information about moirei/custom-email-sender
Files in moirei/custom-email-sender
Package custom-email-sender
Short Description A tool for Laravel's Nova administrator panel that allows you to send custom email messages that within your application that leverages the applications existing settings and configurations.
License MIT
Homepage https://github.com/dniccum/nova-custom-email-sender
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package custom-email-sender
Custom Email Sender for Laravel Nova
This is a tool for Laravel's Nova administrator panel that allows you to send custom email messages that within your application that leverages the applications existing settings and configurations; from address, email driver, etc.
Features
- Inherits your Laravel application's notification Blade layout with any and all modifications and customizations.
- Existing email template can be published to the
views/vendordirectory - Allows you to provide a custom Blade template (with the appropriate variables applied)
- Existing email template can be published to the
- Provides three methods of sending messages:
- Search the provided model by name and email
- Via ad-hoc email input with email address validation
- A simple toggle to send the message to all of your users
- Leverages the Quill WYSIWYG editor with the ability to customize the available buttons/functionality for your users
- Upload a basic HTML file to pre-populate the content for your message
- Language localization
- Preview the message before it's sent
- Various settings to adjust this tool to your installation
Installation
You can install the package via composer:
You will then need to publish the package's configuration and blade view files to your applications installation:
If you would only like to publish a portion of the vendor assets, you may use the following tags:
- config
- views
- lang
with the necessary artisan command like so:
Inside App\Providers\NovaServiceProviderupdate the tools function. This will include the link on the sidebar.
Upgrade from version 1.X
If you are upgrading from version 1.X AND you have modified the tool's default configuration, some please note the changes made to the 'from' property and update your configuration file accordingly.
Send From settings
Below the is the "out-of-the-box" configuration for the 'from' setting:
If you have a custom from address and name, add them as an associative array to the 'options' array, and indicate the default as you see fit.
Models
You can now send emails to multiple models instead of singular model like before.
- The 'class' value within the 'model' configuration is no longer used.
- A new 'classes' value has taken it's place and accepts an array of Eloquent model classes to be passed to it.
Configuration
The configuration items listed below can be found in the novaemailsender.php configuration file.
Example
Modifying "Send From" names and addresses
You have the ability to indicate which email addresses and associated names that your messages come from using the from property in the configuration file:
You can define them via associative array using hard-coded strings, environment variables or configuration variables. Once complete, you may set the default with the 'default' property.
Adding content
When adding content to your message, you have two methods in which to do so. You can either:
- add content using the provided WYSIWYG editor
- upload an HTML file with coded content
Using the file upload method
To upload HTML-based content to use within your message, begin creating a very basic HTML document like so, and save this file anywhere in a local environment (Desktop, Documents, Dropbox, etc):
Within the <body> tag, add the necessary content and any other inline-CSS styles that you wish. Please keep in mind that any CSS you add will override the template that is selected in the configuration.
Once complete, simply toggle the HTML File toggle, click the Select File button to select the file, and then click the Preview button at the bottom to view your content.
Localization / Translation
After the vendor files have been published, you may edit the necessary placeholders in the resources/lang/vendor/custom-email-sender directory.
To Do
- [x] Email preview (thanks @Yelles for the idea!)
- [x] Localization
- [x] Add dynamic autocomplete for app's user Model
- [ ] Add support for Laravel action button components
- [x] Polish up UI
- [ ] Add additional options to further customize the Quill editor
Credits
License
The Nova Custom Email Sender is free software licensed under the MIT license.
