This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
en:devel:sendemailservice [2019/06/22 14:22] joebordes |
en:devel:sendemailservice [2019/08/30 12:58] (current) |
||
---|---|---|---|
Line 3: | Line 3: | ||
coreBOS has an abstraction layer for sending emails, instead of always sending with phpmailer, now we can define a class to send as we want. This allows us to integrate with other email delivery systems such as sendgrid or mailchimp without having to modify the code of the application. | coreBOS has an abstraction layer for sending emails, instead of always sending with phpmailer, now we can define a class to send as we want. This allows us to integrate with other email delivery systems such as sendgrid or mailchimp without having to modify the code of the application. | ||
- | In [[http://blog.corebos.org/en/blog/emailapisendgrid|this blog post]] you can get a general idea of the implications and next we will see how to implement a class of sending emails by studying the sendgrid integration code | + | In [[http://blog.corebos.org/blog/emailapisendgrid|this blog post]] you can get a general idea of the implications and next we will see how to implement a class of sending emails by studying the sendgrid integration code |
The steps to implement an email sending system are | The steps to implement an email sending system are | ||
- | * implement a class with at least 3 static methods | + | * implement a class with at least 3 static methods |
- | * implement an event handler that returns the path and the name of the class | + | * implement an event handler that returns the path and the name of the class |
- | * register the handler | + | * register the handler |
the class must implement these three methods | the class must implement these three methods | ||
Line 21: | Line 21: | ||
The **emailServerCheck** method returns a true or false value depending on whether the service is configured or not. If it returns false we will use the default email delivery system | The **emailServerCheck** method returns a true or false value depending on whether the service is configured or not. If it returns false we will use the default email delivery system | ||
- | The method **sendEMail** is the one that actually does the work of sending the email. It receives all the information it needs to do that. You can [[http://blog.corebos.org/en/blog/SendEmail|read a little about the parameters in this blog post]]. This method must return 1 on ok, any other value is error | + | The method **sendEMail** is the one that actually does the work of sending the email. It receives all the information it needs to do that. You can [[http://blog.corebos.org/blog/SendEmail|read a little about the parameters in this blog post]]. This method must return 1 on ok, any other value is error |
- | podemos ver que la funcionalidad siempre está disponible ya que es la funcionalidad por defecto y que devolveremos verdadero o falso según se haya configurado el servicio o no. | + | Let's talk a little bit about these methods in our sendgrid implementation. These are the methods [[https://github.com/tsolucio/corebos/blob/master/include/integrations/sendgrid/sendgrid.php#L128|useEmailHook]] and [[https://github.com/tsolucio/corebos/blob/master/include/integrations/sendgrid/sendgrid.php#L306|emailServerCheck]] |
- | [[https://github.com/tsolucio/corebos/blob/master/include/integrations/sendgrid/sendgrid.php#L132|aquí puedes ver el método sendEMail]] | + | we can see that the functionality of both is the same and is based simply on whether the client has activated the service or not. We do not check the configuration of the account in SendGrid. |
- | + | ||
- | Ahora implementamos el event handler que devuelve el nombre y ubicación de la clase | + | |
- | + | ||
- | let's talk a little bit about these methods in our sendgrid implementation | + | |
- | + | ||
- | these are the methods [[https://github.com/tsolucio/corebos/blob/master/include/integrations/sendgrid/sendgrid.php#L128|useEmailHook]] and [[https://github.com/tsolucio/corebos/blob/master/include/integrations/sendgrid/sendgrid.php#L306|emailServerCheck]] | + | |
- | + | ||
- | we can see that the functionality is always available since it is the default functionality and that we will return true or false depending on whether the service has been configured or not. | + | |
[[https://github.com/tsolucio/corebos/blob/master/include/integrations/sendgrid/sendgrid.php#L132|here you can see the sendEMail method]] | [[https://github.com/tsolucio/corebos/blob/master/include/integrations/sendgrid/sendgrid.php#L132|here you can see the sendEMail method]] | ||
Now we implement the event handler that returns the name and location of the class | Now we implement the event handler that returns the name and location of the class | ||
- | |||
<code PHP> | <code PHP> | ||
Line 63: | Line 54: | ||
</code> | </code> | ||
- | Con esto solo tenemos que implementar una manera sencilla para que el administrador pueda dar de alta sus datos. Nosotros lo hemos hecho en <code>module=Utilities&action=index</code> | + | With this, we just have to implement a simple way for the administrator to register their data. We have done it in <code>module=Utilities&action=index</code> |
{{:en:devel:emailapi:sendgridconfiguration.png|sendgrid configuration}} | {{:en:devel:emailapi:sendgridconfiguration.png|sendgrid configuration}} | ||
- | En el caso particular de sendgrid, además implementamos una captura de eventos para marcar los distintos estados del mensaje así como lanzar los flujos de trabajo. Esto lo construimos utilizando el servicio de notificaciones de coreBOS (notifications.php) | + | In the particular case of sendgrid, we also implement a capture of events to mark the different states of the message as well as launch the workflows. We built this using the notifications service of coreBOS (notifications.php) |
- | |||
- | With this we just have to implement a simple way for the administrator to register their data. We have done it in <code> module = Utilities & action = index </ code> | ||
- | |||
- | {{: en: devel: emailapi: sendgridconfiguration.png | sendgrid configuration}} | ||
- | |||
- | In the particular case of sendgrid, we also implement a capture of events to mark the different states of the message as well as launch the workflows. We built this using the notifications service of coreBOS (notifications.php) |