Download the PHP package oxemis/oximailing without Composer
On this page you can find all versions of the php package oxemis/oximailing. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package oximailing
Official OxiMailing PHP Wrapper
Overview
This repository contains the official PHP wrapper for the OxiMailing API. To get started, create an account and request your free credits on this page
This library is a wrapper for the OxiMailing API but you don't have to know how to use the API to get started with this library.
What is OxiMailing ?
OxiMailing is a solution designed to enable you to send your emails quickly and easily and in the best possible conditions.
From transactional emails to massive campaigns, we can handle all your needs.
Founded in 2004, OxiMailing focuses on the deliverability of your emails. Our experience and knowledge of the email world enable us to offer you an exceptional quality of service. We're a small team, but we're recognized for the quality of our support and expertise.
Table of contents
- Compatibility
- Installation
- Authentication
- Getting information about your account
- Sending your first email
- How to send customized messages ?
- Tracking a message
- Other features
- Contribute
Compatibility
This library requires PHP v7.4 or higher.
Installation
Use the below code to install the wrapper:
composer require oxemis/oximailing
Authentication
This library is a wrapper to the OxiMailing API. You can request an API KEY in your OxiMailing Account. Free credits are offered.
You should export your API_LOGIN and API_PASSWORD in order to use them in this library :
Initialize your OxiMailing Client:
Getting information about your account
You will find all the information about your OxiMailing account with the "UserAPI" object. Informations returned are documented in the class.
Sending your first email
In order to send a mail, you must instantiate a Message object and, send it, via the $client->sendAPI->Send() method.
PLEASE NOTE
Before sending any message you MUST register your sender email address on your account (or using the
$client->sendersAPIobject). Validated senders can be managed on this page. If your address is not validated, sending will be refused.
You can add attachments, recipients, CC, Reply-To, BCC and many other options with the Message properties.
Every property of the Message object is described with PHPDoc.
Here's a simple sample of how to send a mail (be careful and change the email addresses of the sender and recipients of this example!):
With this sample, OxiMailing will send 2 emails, one to [email protected] and another one to [email protected]. Joe will not see Jane and vice versa !
You can also schedule a sending by using the $mail->setScheduledDateTime($selectedDateAndTime) method.
How to send customized messages?
With this library you can send customized messages based on templating.
Basically, every content between {{ and }} will be replaced by the corresponding recipient metadata.
Here is a simple sample :
Tracking a message
With OxiMailing you'll be able to track events recorded on your emails.
To enable tracking you must use the setTrackEmails = true option of the message and get events using the $client->trackingAPI object.
Here is a simple sample. First send a tracked message :
Then send the message and get the SendingId in return :
After that, you'll be able to get events recorded on this message with the tracking API :
Other features
You'll find a lot of other features by exploring the *API objects in the APIClient.
Here is a non-exhaustive list of these objects (each one is documented with PHPDoc).
blacklistsAPI: get / set your blacklists (lists of unsubscribed recipients)bouncesAPI: get / set your bounces (list of invalid addresses)complaintsAPI: get the list of spam complaints received on your accountdomainsAPI: manage your domains used in OxiMailingsendAPI: send now or schedule your messagessendersAPI: add or remove senders on your accounttrackingAPI: everything related about tracking (statistics on your messages)userAPI: everything about your account
Each object is documented with PHPDoc. Other features will be added in the future. You can also make direct call to the API (and even contribute to this project !). Please take a look at the API Reference 😀
Contribute
Feel free to ask anything, and contribute to this project. Need help ? 👉 [email protected]