CiviCRM Community Forums (archive)

*

News:

Have a question about CiviCRM?
Get it answered quickly at the new
CiviCRM Stack Exchange Q+A site

This forum was archived on 25 November 2017. Learn more.
How to get involved.
What to do if you think you've found a bug.



  • CiviCRM Community Forums (archive) »
  • Old sections (read-only, deprecated) »
  • Support »
  • Using CiviCRM »
  • Using CiviMail (Moderator: Piotr Szotkowski) »
  • Inconsistency in documentation re CiviMail?
Pages: [1]

Author Topic: Inconsistency in documentation re CiviMail?  (Read 1182 times)

nae

  • I post occasionally
  • **
  • Posts: 36
  • Karma: 0
    • Play Australia
  • CiviCRM version: 4.4.7
  • CMS version: Drupal 7.31
  • MySQL version: 5.1
  • PHP version: 5.3
Inconsistency in documentation re CiviMail?
June 04, 2010, 09:56:50 pm
Hello,
I have just finished going through the process of configuring CiviMail and have found what I think is either an inconsistency or mistake in the online documentation OR a misunderstanding on my part. Please advise if possible.

The documentation for CiviMail in the orange online manual at this address: http://en.flossmanuals.net/CiviCRM/SystemConfiguration states that the program that handles the email bounces and flags contacts as invalid, putting them on hold, is EmailProcessor.php.

Where as if you follow the online documentation at this page:
http://wiki.civicrm.org/confluence/display/CRMUPCOMING/CiviMail+Installation
the section on setting up a return channel to handle bounces links to a ‘how to’ page at this address:
http://wiki.civicrm.org/confluence/display/CRMDOC/CiviMail+Processor
which advises that you need to run CiviMail.Processor.php and explains how to do this.

I do not understand the difference in what these two programs are performing.

On my own configuration, I have set up a ‘bounced@mydomain.com’ to catch the return emails, and this is working, with invalid emails being caught, and the contact’s email address is then put on hold. I have set up a cron job to run Email.Processor.php every 10 minutes, and I assume that this program is the one responsible for performing this task.

So, do I need to also run CiviMail.Processor.php as a cron job, and why?

And also, to add a further level of confusion, what about the use of ‘Autofiling’ as described at this page: http://wiki.civicrm.org/confluence/display/CRMDOC/Autofiling+email+activities+via+EmailProcessor
If I am running Email.Processor through cron, can I assume that this autofiling will also take place? The documentation at above page says that:
‘The first time through it will create some folders under /files/civicrm/custom. It stores copies of the emails there.’ I have noticed that these folders have been created on my server, however no files or records have been inserted in them so far, after sending test emails via civiMail.

Any clarification most appreciated,
Renaee.

xcf33

  • I post frequently
  • ***
  • Posts: 181
  • Karma: 7
  • CiviCRM version: 3.3.2
  • CMS version: Drupal 6.19/6.20
  • MySQL version: 5.x
  • PHP version: 5.2.6
Re: Inconsistency in documentation re CiviMail?
June 07, 2010, 07:44:45 am
Hi, I think I can answer the first 2 questions you have with some clarification

1. There are two cron jobs you need to set up if you want CiviCRM to send out email blasts and do bounce processing.

a. sites/all/modules/civicrm/bin/civimail.cronjob.php
b. sites/all/modules/civicrm/bin/CiviMailProcessor.php

Keep in mind that both will require you to enter the query variable for your username, password and your site key which can be set in the civicrm.settings.php

a. will allow the mailing submitted through CiviMail to be picked up by the cron job and cause the mail to be sent out to the SMTP server
b. will pick up all the emails that have been bounced back to the email handler you have set up and parse them and update the bounce statistics.


As for 'Autofilling', I assume the CiviMailProcessor can also parse the reply of certain email into "Email Activities", but I have not had any experience with that yet.


Hope it helps!



Cheers!

xavier

  • Forum Godess / God
  • I’m (like) Lobo ;)
  • *****
  • Posts: 4453
  • Karma: 161
    • Tech To The People
  • CiviCRM version: yes probably
  • CMS version: drupal
Re: Inconsistency in documentation re CiviMail?
June 07, 2010, 12:41:39 pm
Quote from: nae on June 04, 2010, 09:56:50 pm
Hello,
I have just finished going through the process of configuring CiviMail and have found what I think is either an inconsistency or mistake in the online documentation OR a misunderstanding on my part. Please advise if possible.

The documentation for CiviMail in the orange online manual at this address: http://en.flossmanuals.net/CiviCRM/SystemConfiguration states that the program that handles the email bounces and flags contacts as invalid, putting them on hold, is EmailProcessor.php.

The book is more up to date (actually, it describes the 3.2 version, soon to be released).

CiviMail.Processor.php has been replaced by EMailProcessor.php

@Piotr, shouldn't we put a message in CiviMail.Processor saying it's obsoleted ?

Quote from: nae on June 04, 2010, 09:56:50 pm
So, do I need to also run CiviMail.Processor.php as a cron job, and why?

You don't, as you wrote, works fine with EMailProcessor.php ;

Quote from: nae on June 04, 2010, 09:56:50 pm

And also, to add a further level of confusion, what about the use of ‘Autofiling’ as described at this page:
Autofilling creates the activities from incoming emails.

-Hackathon and data journalism about the European parliament 24-26 jan. Watch out the result

nae

  • I post occasionally
  • **
  • Posts: 36
  • Karma: 0
    • Play Australia
  • CiviCRM version: 4.4.7
  • CMS version: Drupal 7.31
  • MySQL version: 5.1
  • PHP version: 5.3
Re: Inconsistency in documentation re CiviMail?
June 07, 2010, 10:14:24 pm
xavier - thankyou for the clarification on this one, as I suspected, the civiMailProcessor.php is not required.
Renaee,

Pages: [1]
  • CiviCRM Community Forums (archive) »
  • Old sections (read-only, deprecated) »
  • Support »
  • Using CiviCRM »
  • Using CiviMail (Moderator: Piotr Szotkowski) »
  • Inconsistency in documentation re CiviMail?

This forum was archived on 2017-11-26.