Jump to content
Pierre-Luc

WireMail Mailgun

Recommended Posts

Started to use this module and works fine so far, thanks!

Is there a way to use the built-in WireMail in certain cases? Eg. I need to use MailGun only for newsletter emails.

Share this post


Link to post
Share on other sites

Just found that I have to comment out this line to make tags work:

$tag = transliterator_transliterate('Any-Latin; Latin-ASCII; [\u0080-\u7fff] remove', $tag);

Could it be the server environment or maybe something else?

Share this post


Link to post
Share on other sites

this may be a question i'd need to submit as a support ticket to mailgun, as their documentations is pretty sparse, but is it even possible to switch out the sending domain when you send a message, because my CRM app has a selectable "From" address when sending an email and that can be from one of 8 different domains. Since the mailgun api has you put in the api key for a particular domain, will it reject the email if it has a different from domain, or will it auto-detect the domain and switch to that; the difference here between this and Mandrill for example is that Mandrill doesn't require different smtp credentials for each domain...

EDIT: so i reviewed the Mailgun documentation and it does seem that you need to authenticate for the domain you are sending from; so now i wonder if i could just change my script to read the domain from the sender and then set the domain and api key for that message;

$WireMailMailgun->setApiKey( string $apiKey )

$WireMailMailgun->setDomainName( string $domainName ) :cool:

Share this post


Link to post
Share on other sites

Started to use this module and works fine so far, thanks!

Is there a way to use the built-in WireMail in certain cases? Eg. I need to use MailGun only for newsletter emails.

Hmm, I'm not sure to be honest! I think once you instantiate the WireMail class it will automatically call the installed module. Maybe Ryan has an idea on this.. 

Share this post


Link to post
Share on other sites

Just found that I have to comment out this line to make tags work:

$tag = transliterator_transliterate('Any-Latin; Latin-ASCII; [\u0080-\u7fff] remove', $tag);

Could it be the server environment or maybe something else?

If you run this :

echo transliterator_transliterate('Any-Latin; Latin-ASCII; [\u0080-\u7fff] remove', "YOUR TAG HERE");

in PHP in interactive mode on your host, (php -a .. then type in commands), what's the output, and what was the exact input for "your tag here".

Also do your setup satisfy both requirements >> PHP >= 5.4.0, PECL int >= 2.0.0? It's weird that it would give out an error since it succeeds checking the function exists. Also anything comes up in Logs > Mailgun ?

Share this post


Link to post
Share on other sites

EDIT: so i reviewed the Mailgun documentation and it does seem that you need to authenticate for the domain you are sending from; so now i wonder if i could just change my script to read the domain from the sender and then set the domain and api key for that message;

$WireMailMailgun->setApiKey( string $apiKey )

$WireMailMailgun->setDomainName( string $domainName ) :cool:

Bingo! :)

Share this post


Link to post
Share on other sites

These are my findings - seems that intl is the culprit:

php 7.05
intl 1.1.0

PHP Warning: transliterator_transliterate(): Could not create transliterator with ID "Any-Latin; Latin-ASCII; [\u0080-\u7fff] remove" (transliterator_create: unable to open ICU transliterator with id "Any-Latin; Latin-ASCII; [\u0080-\u7fff] remove": U_INVALID_ID)

There are no related lines in mailgun log txt file.

My tags were simple words like "newsletter" or "test".

Share this post


Link to post
Share on other sites

@tpr, what OS? I have the same intl version on my test box. It seems your build might be linking the wrong ICU (outdated) package.

I just added a check in the module to test if the transliterator ID was valid on a given system. https://github.com/plauclair/WireMailMailgun/releases/tag/0.4.2

Note that I am not able to replicate your environment or the issue, so please let if know if this release corrects the issue on your end.

  • Like 1

Share this post


Link to post
Share on other sites

it's CentOS 6.6 I don't have direct access to it, only through Plesk.

After the update the tags appear in the MailGun logs, thanks!

  • Like 1

Share this post


Link to post
Share on other sites

This is the first time I've used WireMail and WireMail Mailgun and I'm having a problem where mail is showing as delivered in the Mailgun logs but nothing appears in my inbox, or in spam folder. Solved: see edit below

If someone can confirm I've followed the installation and setup correctly...

1. Open account at Mailgun, choosing domain mg.mydomain.com

2. Set up TXT, CNAME and MX records for mg.mydomain.com at domain registrar, according the values provided by Mailgun. Mailgun verifies these records are set correctly.

3. Installed WireMail Mailgun module

4. Configured WireMail Mailgun module, filling out all fields. Unchecked "Disable cURL SSL Check". Default Sender Email Address: no-reply@mg.mydomain.com (does this need to be an address where there is an actual mailbox to receive replies?)

5. Tried to send test message by putting the following in a template file and viewing from frontend:

$mail = wireMail();
$mail->to('myaddress@gmail.com')->from('no-reply@mg.mydomain.com');
$mail->subject('Testing Mailgun');
$mail->body( 'Just testing.' );
$mail->send();

In the Mailgun dashboard I can see entries in the log for mg.mydomain.com like

Test delivered: no-reply@mg.mydomain.com → myaddress@gmail.com 'Testing Mailgun'

But no mail arrives to me. Mailgun does not show any bounces or errors.

The label "Test delivered" makes me wonder - is Mailgun in some sort of test mode? I'm not using the sandbox feature.

Looked for entries in /site/assets/logs/mailgun.txt but no such log exists. Is that normal?

Any help much appreciated.

Edit: I obviously should have looked more closely at the module config. Maybe this should be unchecked by default? Yeah, excuses, excuses... :)

post-2897-0-47316100-1462498905_thumb.pn

Share this post


Link to post
Share on other sites

I am not certain, however I noticed that you are including Gmail in your test.  This is a note from the Mailgun User Manual that may apply to your situation.

 Why am I not receiving an email when sending via the route with the sending address as a destination?

You’re most likely using GMail for sending your message. From GMail’s documentation (https://support.google.com/mail/troubleshooter/2935079?rd=1):

Finally, if you’re sending mail to a mailing list that you subscribe to, those messages will only appear in ‘Sent Mail.’ This behavior also occurs when sending to an email address that automatically forwards mail back to your Gmail address. To test forwarding addresses or mailing lists, use a different email address to send your message.

When a message from, say, bob@gmail.com goes through a route:

test@mailgun-domain.com -> bob@gmail.com

When this message arrives to GMail, it will have bob@gmail.com as both sender and recipient, therefore GMail will not show it.

In other words GMail does not show you messages you sent to yourself.

The other possibility is that the address had previously experienced a Hard Bounce and is on the ‘do not send’ list. Check the Bounces tab for a list of these addresses and remove the address in question if it is there.

 

Source:  https://documentation.mailgun.com/faqs.html#why-am-i-not-receiving-an-email-when-sending-via-the-route-with-the-sending-address-as-a-destination

Gmail doesn't like sending anything to the same Gmail address.  You may want to try sending your test using another provider.

  • Like 1

Share this post


Link to post
Share on other sites

Thanks, all solved now as per the edit to my post. Just needed to uncheck "Enable Test Mode" in the module config.

  • Like 1

Share this post


Link to post
Share on other sites

I'm working on converting a site from WireMailSMTP + Mandrill to using Mailgun.
In case anyone else needs to do this i'm posting the steps and snafus here. So far in adapting the existing code, the differences i have logged so far are;

1.)

 

in WireMailSMTP you have to set sendSingle(true) if you want the messages to each be sent individually, but this is the default for WireMailMailgun, so that call gets removed.

2.)
the method for adding attachments differs:

this:
$mail->attachment(string $filepath);

becomes this:
$mail->addAttachment(string $filepath);

3.)
If your site sends from different domains, then you need to switch that setting before send.
It appears to me that the API key is the same for all my domains, so I should only need to change the one setting when i send the email assuming i have already entered the API key in the WireMailMailgun module settings, then i can extract the domain of sending email address and set the domain to that (and also assuming I have all of those domains configured in Mailgun).

$domain = substr(strrchr($identity->email, "@"), 1);
$mail->setDomainName($domain);

*** This doesn't actually work because the runtime setting is not overriding the domain that is set in the ___send() options. ***

I made modifications to the module and now i have this working with my system; would probably need another setting like "match "sending domain" to "from email" domain" or something and also make the domain field optional in the module settings..

https://github.com/plauclair/WireMailMailgun/issues/7

------------------------------------------------------------------------------------------------------------

Additional comments and observations:

- would also be nice if an attachment() method could simply be added which aliases the other method (would save some code checks)

 

  • Like 1

Share this post


Link to post
Share on other sites

No. 1 is a violation of the WireMail interface, which says send() should return an integer and not a boolean. This should rather be changed in the module than in user-code. 

  • Like 1

Share this post


Link to post
Share on other sites

you mean so around line 132 changing like this:

switch ($info['http_code']) {
	case 200:
	//return true; // Can't set int for number sent, since Mailgun doesn't return that data
	return 1; // this instead ?
	break;
...

 

Share this post


Link to post
Share on other sites
4 minutes ago, LostKobrakai said:

At least. Better would still be to possibly return the actual number of sent emails. 

I agree but Mailgun doesn't return that info. I felt like returning true might be better since at least it's not giving you fake info. Further faking it might include counting the number of addresses in the emails array, but that feels even worse to me. 

For the other methods, I'd be more than happy if the interface was updated so we could standardize on things like attachments.

Share this post


Link to post
Share on other sites

I'd like to see that, too, especially as it's probably only left out because it wasn't part of the pw native implementation. Maybe we could just have a WireMailAttachments interface for that?!

  • Like 1

Share this post


Link to post
Share on other sites

You could do

```

return count($this->getToRecipients()) + count($this->getCCRecipients()) + count($this->getBCCRecipients());

```

Share this post


Link to post
Share on other sites

Well there's quite a few things lacking if you ask me, CC, BCC, attachments, batch mode on/off. I don't know if these are mail() constraints, I never use that thing. Basic things in email protocols are left out I believe because you could hack things up with the headers method, but that's far from an obvious thing especially for beginners. I don't have much preference on adding to the WireMail class, or having a supplemental interface to implement, or else. 

Personally I believe the interface specification for send should not be an int, but a true-ish or a false-ish value. Many ways of sending mail don't return numbers sent, but will tell you if it went ok or not. By the very nature of email, it could take hours/days until an email is certified as being accepted by the receiving servers, and some email servers don't even return accept/decline messages.

true/1…n should be correct return values for success, false/0 should also be correct for failure. It's just a matter of documenting it and using == instead of ===.  It's all fun insisting on integers but if we can't realistically meet those requirements it's just for show..

  • Like 2

Share this post


Link to post
Share on other sites

So after some hours of testing/research/code experiments, that yielded the modifications I made to the module as noted on GitHub, i can now send messages with the ability to switch between the sending domain and it all works. (also see edited post above).

Goodbye Mandrill! :P

  • Like 2

Share this post


Link to post
Share on other sites
On 6/25/2016 at 8:13 AM, Pierre-Luc said:

I agree but Mailgun doesn't return that info.

@Pierre-Luc is there still no way to get feedback on success/errors when sending through the Mailgun API?

I would like to build a Lister(Pro) Action around your module and for that I would like to show results after sending. Something like $mail->getResult(); in WireMailSMTP.

EDIT: Guess I would need to use Mailgun Events for tracking emails. Right?

  • Like 1

Share this post


Link to post
Share on other sites

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.

Guest
Reply to this topic...

×   Pasted as rich text.   Paste as plain text instead

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.


  • Recently Browsing   0 members

    No registered users viewing this page.

  • Similar Content

    • By Robin S
      Repeater Images
      Adds options to modify Repeater fields to make them convenient for "page-per-image" usage. Using a page-per-image approach allows for additional fields to be associated with each image, to record things such as photographer, date, license, links, etc.
      When Repeater Images is enabled for a Repeater field the module changes the appearance of the Repeater inputfield to be similar (but not identical) to an Images field. The collapsed view shows a thumbnail for each Repeater item, and items can be expanded for field editing.
      Screencast

      Installation
      Install the Repeater Images module.
      Setup
      Create an image field to use in the Repeater field. Recommended settings for the image field are "Maximum files allowed" set to 1 and "Formatted value" set to "Single item (null if empty)". Create a Repeater field. Add the image field to the Repeater. If you want additional fields in the Repeater create and add these also. Repeater Images configuration
      Tick the "Activate Repeater Images for this Repeater field" checkbox. In the "Image field within Repeater" dropdown select the single image field. You must save the Repeater field settings to see any newly added Image fields in the dropdown. Adjust the image thumbnail height if you want (unlike the core Images field there is no slider to change thumbnail height within Page Edit). Note: the depth option for Repeater fields is not compatible with the Repeater Images module.
      Image uploads feature
      There is a checkbox to activate image uploads. This feature allows users to quickly and easily add images to the Repeater Images field by uploading them to an adjacent "upload" field.
      To use this feature you must add the image field selected in the Repeater Images config to the template of the page containing the Repeater Images field - immediately above or below the Repeater Images field would be a good position.
      It's recommended to set the label for this field in template context to "Upload images" or similar, and set the visibility of the field to "Closed" so that it takes up less room when it's not being used. Note that when you drag images to a closed Images field it will automatically open. You don't need to worry about the "Maximum files allowed" setting because the Repeater Images module overrides this for the upload field.
      New Repeater items will be created from the images uploaded to the upload field when the page is saved. The user can add descriptions and tags to the images while they are still in the upload field and these will be retained in the Repeater items. Images are automatically deleted from the upload field when the page is saved.
      Tips
      The "Use accordion mode?" option in the Repeater field settings is useful for keeping the inputfield compact, with only one image item open for editing at a time. The "Repeater item labels" setting determines what is shown in the thumbnail overlay on hover. Example for an image field named "image": {image.basename} ({image.width}x{image.height})  
      https://github.com/Toutouwai/RepeaterImages
      https://modules.processwire.com/modules/repeater-images/
    • By EyeDentify
      Hello There Guys.

      I am in the process of getting into making my first modules for PW and i had a question for you PHP and PW gurus in here.

      I was wondering how i could use an external library, lets say TwitterOAuth in my PW module.
      Link to library
      https://twitteroauth.com/

      Would the code below be correct or how would i go about this:
      <?PHP namespace ProcessWire; /* load the TwitterOAuth library from my Module folder */ require "twitteroauth/autoload.php"; use Abraham\TwitterOAuth\TwitterOAuth; class EyeTwitter extends WireData,TwitterOAuth implements Module { /* vars */ protected $twConnection; /* extend parent TwitterOAuth contructor $connection = new TwitterOAuth(CONSUMER_KEY, CONSUMER_SECRET, $access_token, $access_token_secret); */ public function myTwitterConnection ($consumer_key, $consumer_secret, $access_token, $access_token_secret) { /* save the connection for use later */ $this->twConnection = TwitterOAuth::__construct($consumer_key, $consumer_secret, $access_token, $access_token_secret); } } ?> Am i on the right trail here or i am barking up the wrong tree?
      I don´t need a complete solution, i just wonder if i am including the external library the right way.
      If not, then give me a few hint´s and i will figure it out.

      Thanks a bunch.

      /EyeDentify
    • By dimitrios
      Hello,
      this module can publish content of a Processwire page on a Facebook page, triggered by saving the Processwire page.
      To set it up, configure the module with a Facebook app ID, secret and a Page ID. Following is additional configuration on Facebook for developers:
      Minimum Required Facebook App configuration:
      on Settings -> Basics, provide the App Domains, provide the Site URL, on Settings -> Advanced, set the API version (has been tested up to v3.3), add Product: Facebook Login, on Facebook Login -> Settings, set Client OAuth Login: Yes, set Web OAuth Login: Yes, set Enforce HTTPS: Yes, add "http://www.example.com/processwire/page/" to field Valid OAuth Redirect URIs. This module is configurable as follows:
      Templates: posts can take place only for pages with the defined templates. On/Off switch: specify a checkbox field that will not allow the post if checked. Specify a message and/or an image for the post.
      Usage
      edit the desired PW page and save; it will post right after the initial Facebook log in and permission granting. After that, an access token is kept.
       
      Download
      PW module directory: http://modules.processwire.com/modules/auto-fb-post/ Github: https://github.com/kastrind/AutoFbPost   Note: Facebook SDK for PHP is utilized.


    • By kongondo
      FieldtypeRuntimeMarkup and InputfieldRuntimeMarkup
       
      Modules Directory: http://modules.processwire.com/modules/fieldtype-runtime-markup/
      GitHub: https://github.com/kongondo/FieldtypeRuntimeMarkup
      As of 11 May 2019 ProcessWire versions earlier than 3.x are not supported
      This module allows for custom markup to be dynamically (PHP) generated and output within a page's edit screen (in Admin).
       
      The value for the fieldtype is generated at runtime. No data is saved in the database. The accompanying InputfieldRuntimeMarkup is only used to render/display the markup in the page edit screen.
       
      The field's value is accessible from the ProcessWire API in the frontend like any other field, i.e. it has access to $page and $pages.
       
      The module was commissioned/sponsored by @Valan. Although there's certainly other ways to achieve what this module does, it offers a dynamic and flexible alternative to generating your own markup in a page's edit screen whilst also allowing access to that markup in the frontend. Thanks Valan!
       
      Warning/Consideration
      Although access to ProcessWire's Fields' admin pages is only available to Superusers, this Fieldtype will evaluate and run the custom PHP Code entered and saved in the field's settings (Details tab). Utmost care should therefore be taken in making sure your code does not perform any CRUD operations!! (unless of course that's intentional) The value for this fieldtype is generated at runtime and thus no data is stored in the database. This means that you cannot directly query a RuntimeMarkup field from $pages->find(). Usage and API
       
      Backend
      Enter your custom PHP snippet in the Details tab of your field (it is RECOMMENDED though that you use wireRenderFile() instead. See example below). Your code can be as simple or as complicated as you want as long as in the end you return a value that is not an array or an object or anything other than a string/integer.
       
      FieldtypeRuntimeMarkup has access to $page (the current page being edited/viewed) and $pages. 
       
      A very simple example.
      return 'Hello'; Simple example.
      return $page->title; Simple example with markup.
      return '<h2>' . $page->title . '</h2>'; Another simple example with markup.
      $out = '<h1>hello '; $out .= $page->title; $out .= '</h1>'; return $out; A more advanced example.
      $p = $pages->get('/about-us/')->child('sort=random'); return '<p>' . $p->title . '</p>'; An even more complex example.
      $str =''; if($page->name == 'about-us') { $p = $page->children->last(); $str = "<h2><a href='{$p->url}'>{$p->title}</a></h2>"; } else { $str = "<h2><a href='{$page->url}'>{$page->title}</a></h2>"; } return $str; Rather than type your code directly in the Details tab of the field, it is highly recommended that you placed all your code in an external file and call that file using the core wireRenderFile() method. Taking this approach means you will be able to edit your code in your favourite text editor. It also means you will be able to type more text without having to scroll. Editing the file is also easier than editing the field. To use this approach, simply do:
      return wireRenderFile('name-of-file');// file will be in /site/templates/ If using ProcessWire 3.x, you will need to use namespace as follows:
      return ProcessWire\wireRenderFile('name-of-file'); How to access the value of RuntimeMarkup in the frontend (our field is called 'runtime_markup')
       
      Access the field on the current page (just like any other field)
      echo $page->runtime_markup; Access the field on another page
      echo $pages->get('/about-us/')->runtime_markup; Screenshots
       
      Backend
       

       

       
      Frontend
       

×
×
  • Create New...