CiviCRM Community Forums (archive)

Hi all,

I'm trying to programmatically add a CiviMail Job on a daily basis using a premade mail template that I've saved in CiviMail.

I believe this would need to be in a module and would need to call a function to create that Job. But I'm pretty confused about how to actually add a new job AND pull that template using only code.

After that's figured out, I suppose i'd just use scheduled cron jobs to get it sent at a specific time each day.

what function(s) handle the creation of the mailer and the job now?

the other thing that was just brought to my attention is that civimail was not completing jobs properly when there were too many recipients (3.3.1), and the solution was to break it down into smaller jobs (3.3.2), when exactly does that breaking down process happen? and would creating a job with code interfere with that?

After looking into those files, I found something promising, but there is entirely too many referenced variables and functions for me to be sure that it does what I think it does without having a conversation with whoever wrote these functions.

In the BAO Mailing.php file, I found that the functions in the CRM_Mailing_BAO_Mailing class called "add" and "create" seem to be relevant.

Add:
/**
     * function to add the mailings
     *
     * @param array $params reference array contains the values submitted by the form
     * @param array $ids    reference array contains the id
     *
     * @access public
     * @static
     * @return object
     */
    static function add( &$params, &$ids )
and Create:
/**
     * Construct a new mailing object, along with job and mailing_group
     * objects, from the form values of the create mailing wizard.
     *
     * @params array $params        Form values
     * @return object $mailing      The new mailing object
     * @access public
     * @static
     */
    public static function create( &$params, &$ids )
Additionally, I investigated the Job.php file, also located in BAO, and found that, while there are obviously relevant variables to things like dates, status, types, job limits, and such, it doesn't appear that Job.php really performs the task of actually adding a job to the queue. Instead I would guess that it is happening in mailer, perhaps in create / add, which was mentioned above.

Is any of that true?

What function creates the parent job?