Download the PHP package passionweb/mailjet-api without Composer

On this page you can find all versions of the php package passionweb/mailjet-api. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

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 PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • 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.
Please rate this library. Is it a good library?

Informations about the package mailjet-api

Mailjet API extension for TYPO3

What does it do?

This extension uses the Mailjet API so users can subscribe to your newsletter(s) and be added to your Mailjet mailing list(s). It comes with two plugins. One with the mailjet subscription form and one with the mailjet verification form.

You can customize the subscription form to your individual (Mailjet) needs. You can choose which fields should be displayed and how they are mapped to the corresponding contact fields in Mailjet, which field(s) should be used for the receiver name and which field should be used for the email.

Requirements

Installation

composer require "passionweb/mailjet-api"

Configuration

Necessary RouteEnhancer

Frontend configuration "enforceValidation" and "excludedParameters" (TYPO3 v12)

You need to add the contact_id parameter to the excludedParameters if you don't use the limitToPages option of the RouteEnhancer and if it should be possible to call the same page (where your mailjet verification plugin is included) with the contact_id as an argument and without the contact_id.

$GLOBALS['TYPO3_CONF_VARS']['FE']['cacheHash'] = [
    'enforceValidation' => true,
    'excludedParameters' => [
        'contact_id',
    ],
];

Extension configuration

There are the following extension settings available.

# cat=Mailjet settings; type=string; label=Mailjet API key;
mailjetApiKey= YOUR_MAILJET_API_KEY

Enter your Mailjet API key.

# cat=Mailjet settings; type=string; label=Mailjet secret key;
mailjetSecretKey= YOUR_MAILJET_SECRET_KEY

Enter your Mailjet secret key.

# cat=Mailjet settings; type=string;  label=Mailjet API version
mailjetApiVersion = v3

Enter the current Mailjet API version.

How editors should use the extension

Add your required properties

The properties are used to define the fields for the subscription form and the associated mapping to the Mailjet fields. The following fields are available:

  1. Form property name: The name of the property in the subscription form
  2. Mailjet property name: The name of the (contact) property in Mailjet
  3. Form property type: Select the type of the field in the subscription form (possible values: text, email, tel, number, url)
  4. Form field placeholder: The placeholder text for the field in the subscription form
  5. Form field required: Select if the current field is required in the subscription form or not (default: false)
  6. Use for Mailjet name: Select if the current field should be used for the name in your Mailjet subscription and verification email (default: false)
  7. Use for Mailjet email: Select if the current field should be used for the email in your Mailjet subscription and verification email (default: false)

Add and configure plugin "Mail subscription form"

  1. Add the plugin "Mailjet subscription form" to your selected page
  2. Configure the plugin settings:

    • Storage Pid: select the storage where subscription records should be stored
    • Form fields/properties: Select all properties you want to use in your subscription form
    • Form field for the email address: Select the property you want to use for the email address in your subscription email
    • Form field(s) for the email receiver name: Select the property or properties you want to use for the receiver name in your subscription email
    • Mailjet ListID: Enter the ID of the Mailjet list you want to use for the subscription
    • From email for subscription email: Enter the email you want to use as the sender of your subscription email
    • From name for subscription email: Enter the name you want to use as the sender of your subscription email
    • Subject for subscription email: Enter the subject you want to use for your subscription email
    • Mailjet TemplateID for subscription email: Enter the ID of the Mailjet template you want to use for the subscription email
    • Redirect to page after form submit: select the page where users should be redirected after submitting the subscription form

Add and configure plugin "Mail verify subscription"

  1. Add the plugin "Mailjet verify subscription" to your selected page (should be different from the page with the subscription form)
  2. Configure the plugin settings:

    • Mailjet ListID: Enter the ID of the Mailjet list you want to use for the verification (must be the same as in the plugin "Mail subscription form")
    • From email for verification email: Enter the email you want to use as the sender of your verification email
    • From name for verification email: Enter the name you want to use as the sender of your verification email
    • Subject for verification email: Enter the subject you want to use for your verification email
    • Mailjet TemplateID for verification email: Enter the ID of the Mailjet template you want to use for the verification email

Important notes

The extension uses the external service Mailjet. To use the extension, you need a Mailjet account and an API key For more information visit the Mailjet website.

Troubleshooting and logging

If something does not work as expected take a look at the log file first. Every problem is logged to the TYPO3 log (normally found in var/log/typo3_*.log)

Achieving more together or Feedback, Feedback, Feedback

I'm grateful for any feedback! Be it suggestions for improvement, extension requests or just a (constructive) feedback on how good or crappy the extension is.

Feel free to send me your feedback to contact me on Slack


All versions of mailjet-api with dependencies

PHP Build Version
Package Version
Requires php Version >=7.4.0
typo3/cms-core Version ^11.5 | ^12.4
mailjet/mailjet-apiv3-php Version ~1.6
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package passionweb/mailjet-api contains the following files

Loading the files please wait ....