Version 4.0.13.1

This commit is contained in:
Neo committed 2025-12-19 04:57:54 -08:00
1 parent f9e857d255
commit c6a86f0d9b
7517 files changed
+597400 -668041

No files matched your search

@@ -0,0 +1,540 @@
<?php
/**
* @brief Bulk mail handler
* @author <a href='http://www.invisionpower.com'>Invision Power Services, Inc.</a>
* @copyright (c) 2001 - SVN_YYYY Invision Power Services, Inc.
* @license http://www.invisionpower.com/legal/standards/
* @package IPS Social Suite
* @since 18 Jun 2013
* @version SVN_VERSION_NUMBER
*/
namespace IPS\core\modules\admin\bulkmail;
/* To prevent PHP errors (extending class does not exist) revealing path */
if ( !defined( '\IPS\SUITE_UNIQUE_KEY' ) )
{
header( ( isset( $_SERVER['SERVER_PROTOCOL'] ) ? $_SERVER['SERVER_PROTOCOL'] : 'HTTP/1.0' ) . ' 403 Forbidden' );
exit;
}
/**
* Bulk mail management
*/
class _bulkmail extends \IPS\Dispatcher\Controller
{
/**
* Execute
*
* @return void
*/
public function execute()
{
\IPS\Dispatcher::i()->checkAcpPermission( 'bulkmail_manage' );
/* Make sure we have a community outgoing email */
if ( !\IPS\Settings::i()->email_out )
{
\IPS\Output::i()->error( 'no_outgoing_address', '1C125/9', 403, '' );
}
parent::execute();
}
/**
* Manage
*
* @return void
*/
public function manage()
{
/* Create the table */
$table = new \IPS\Helpers\Table\Db( 'core_bulk_mail', \IPS\Http\Url::internal( 'app=core&module=bulkmail&controller=bulkmail' ) );
$table->langPrefix = 'bulkmail_';
$table->mainColumn = 'mail_subject';
$table->include = array( 'mail_subject', 'mail_start', 'mail_sentto', 'mail_taken' );
$table->quickSearch = 'mail_subject';
/* Default sort options */
$table->sortBy = $table->sortBy ?: 'mail_start';
$table->sortDirection = $table->sortDirection ?: 'desc';
/* Custom parsers */
$table->parsers = array(
'mail_start' => function( $val, $row )
{
if( !$val )
{
return \IPS\Member::loggedIn()->language()->addToStack('bulkmail_notstarted');
}
return \IPS\DateTime::ts( $val )->localeDate();
},
'mail_sentto' => function( $val, $row )
{
return \IPS\Member::loggedIn()->language()->addToStack( 'bulkmail_sentto_members', FALSE, array( 'pluralize' => array( (int) $val ) ) );
},
'mail_taken' => function( $val, $row )
{
if( !$row['mail_updated'] )
{
return \IPS\Member::loggedIn()->language()->addToStack('bulkmail_notstarted');
}
$started = \IPS\DateTime::ts( $row['mail_start'] );
$updated = \IPS\DateTime::ts( $row['mail_updated'] );
return \IPS\DateTime::formatInterval( $updated->diff( $started ) );
}
);
/* Specify the buttons */
if ( \IPS\Member::loggedIn()->hasAcpRestriction( 'core', 'bulkmail', 'bulkmail_add' ) )
{
$table->rootButtons = array(
'add' => array(
'icon' => 'plus',
'title' => 'bulkmail_add',
'link' => \IPS\Http\Url::internal( 'app=core&module=bulkmail&controller=bulkmail&do=form' ),
)
);
}
$table->rowButtons = function( $row )
{
$return = array();
if ( \IPS\Member::loggedIn()->hasAcpRestriction( 'core', 'bulkmail', 'bulkmail_edit' ) )
{
$return['edit'] = array(
'icon' => 'pencil',
'title' => 'edit',
'link' => \IPS\Http\Url::internal( 'app=core&module=bulkmail&controller=bulkmail&do=form&id=' ) . $row['mail_id'],
);
if( $row['mail_active'] )
{
$return['cancel'] = array(
'icon' => 'minus-circle',
'title' => 'cancel',
'link' => \IPS\Http\Url::internal( 'app=core&module=bulkmail&controller=bulkmail&do=cancel&id=' ) . $row['mail_id'],
);
if ( \IPS\Settings::i()->mandrill_api_key AND \IPS\Settings::i()->mandrill_use_for )
{
$return['resend'] = array(
'icon' => 'share',
'title' => 'continue_sending',
'link' => \IPS\Http\Url::internal( 'app=core&module=bulkmail&controller=bulkmail&resetTask=1&do=sendMandrill&id=' ) . $row['mail_id'],
);
}
}
else
{
$return['resend'] = array(
'icon' => 'refresh',
'title' => 'resend',
'link' => \IPS\Http\Url::internal( 'app=core&module=bulkmail&controller=bulkmail&do=resend&id=' ) . $row['mail_id'],
);
}
}
if ( \IPS\Member::loggedIn()->hasAcpRestriction( 'core', 'bulkmail', 'bulkmail_delete' ) )
{
$return['delete'] = array(
'icon' => 'times-circle',
'title' => 'delete',
'link' => \IPS\Http\Url::internal( 'app=core&module=bulkmail&controller=bulkmail&do=delete&id=' ) . $row['mail_id'],
'data' => array( 'delete' => '' ),
);
}
return $return;
};
/* Shortcut to Mandrill configuration */
\IPS\Output::i()->sidebar['actions'] = array(
'configure' => array(
'title' => 'mandrill_cross_link',
'icon' => 'cog',
'link' => \IPS\Http\Url::internal( "app=core&module=applications&controller=enhancements&do=edit&id=core_Mandrill" ),
),
);
/* Display */
\IPS\Output::i()->title = \IPS\Member::loggedIn()->language()->addToStack('manage_bulk_mail');
\IPS\Output::i()->output = \IPS\Theme::i()->getTemplate( 'global' )->block( 'title', (string) $table );
}
/**
* Delete a bulk mail
*
* @return void
*/
public function delete()
{
/* Retrieve the bulk mail details for the log */
try
{
$mail = \IPS\core\BulkMail\Bulkmailer::load( (int) \IPS\Request::i()->id );
}
catch( \OutOfRangeException $e )
{
\IPS\Output::i()->error( 'couldnt_find_bulkmail', '2C125/7', 404, '' );
}
/* Delete the bulk mail */
$mail->delete();
/* Reset bulk mail task */
\IPS\core\BulkMail\Bulkmailer::updateTask();
/* Log and redirect */
\IPS\Session::i()->log( 'acplog__bulkmail_deleted', array( $mail->subject => FALSE ) );
\IPS\Output::i()->redirect( \IPS\Http\Url::internal( 'app=core&module=bulkmail&controller=bulkmail' ), 'deleted' );
}
/**
* Cancel a bulk mail
*
* @return void
*/
public function cancel()
{
/* Retrieve the bulk mail details for the log */
try
{
$mail = \IPS\core\BulkMail\Bulkmailer::load( (int) \IPS\Request::i()->id );
}
catch( \OutOfRangeException $e )
{
\IPS\Output::i()->error( 'couldnt_find_bulkmail', '2C125/8', 404, '' );
}
/* Cancel the bulk mail */
$mail->updated = time();
$mail->active = 0;
$mail->save();
/* Reset bulk mail task */
\IPS\core\BulkMail\Bulkmailer::updateTask();
/* Log and redirect */
\IPS\Session::i()->log( 'acplog__bulkmail_cancelled', array( $mail->subject => FALSE ) );
\IPS\Output::i()->redirect( \IPS\Http\Url::internal( 'app=core&module=bulkmail&controller=bulkmail' ), 'cancelled' );
}
/**
* Resend a bulk mail
*
* @return void
* @see _bulkmail::send()
* @note This method simply redirects to the preview() method
*/
public function resend()
{
return $this->preview();
}
/**
* Begin sending a bulk mail. This method will display a preview form and allow the administrator to confirm before initiating the bulk mail send process.
*
* @return void
* @note The resend() method redirects here. Additionally, upon successfully saving a bulk mail the user is redirected here.
*/
public function preview()
{
/* Retrieve the bulk mail details */
try
{
$mail = \IPS\core\BulkMail\Bulkmailer::load( (int) \IPS\Request::i()->id );
}
catch( \OutOfRangeException $e )
{
\IPS\Output::i()->error( 'couldnt_find_bulkmail', '2C125/1', 404, '' );
}
/* Get the members */
$results = $mail->getQuery( array( 0, 1000 ) );
/* Get a count of the members */
$total = $results->count( TRUE );
/* Do we have anyone to send to? */
if( !$total )
{
/* Disable the bulk mail - nothing to send */
if( $mail->active )
{
$mail->active = 0;
$mail->save();
}
\IPS\Output::i()->error( 'no_members_to_send_to', '1C125/3', 400, '' );
}
/* Output */
\IPS\Output::i()->title = \IPS\Member::loggedIn()->language()->addToStack('bm_send_preview');
if( !\IPS\Settings::i()->mandrill_api_key )
{
\IPS\Output::i()->output = \IPS\Theme::i()->getTemplate( 'global' )->message( 'bulkmail_send_info', 'information' );
}
\IPS\Output::i()->output .= \IPS\Theme::i()->getTemplate( 'members' )->bulkMailPreview( $mail, $results, $total );
}
/**
* Show a preview of the email that will be sent inside an iframe. This allows us to use the email template properly.
*
* @return void
*/
public function iframePreview()
{
/* Retrieve the bulk mail details */
try
{
$mail = \IPS\core\BulkMail\Bulkmailer::load( (int) \IPS\Request::i()->id );
}
catch( \OutOfRangeException $e )
{
\IPS\Output::i()->error( 'couldnt_find_bulkmail', '2C125/2', 404, '' );
}
/* Format the email */
$email = \IPS\Email::buildFromContent( $mail->subject, $mail->formatBody( \IPS\Member::loggedIn() ) );
$email->buildUnsubscribe( 'bulk', \IPS\Member::loggedIn() );
\IPS\Output::i()->sendOutput( $email->body['html'] );
}
/**
* Actually send the bulk mail. We end up here once the preview has been confirmed the admin continues.
*
* @return void
*/
public function send()
{
/* Retrieve the bulk mail details */
try
{
$mail = \IPS\core\BulkMail\Bulkmailer::load( (int) \IPS\Request::i()->id );
}
catch( \OutOfRangeException $e )
{
\IPS\Output::i()->error( 'couldnt_find_bulkmail', '2C125/5', 404, '' );
}
/* Make this bulk mail active */
$mail->active = 1;
$mail->start = time();
$mail->sentto = 0;
$mail->save();
/* Reset bulk mail task */
\IPS\core\BulkMail\Bulkmailer::updateTask();
/* And redirect */
if( \IPS\Settings::i()->mandrill_api_key AND \IPS\Settings::i()->mandrill_use_for )
{
return $this->sendMandrill();
}
else
{
\IPS\Output::i()->redirect( \IPS\Http\Url::internal( 'app=core&module=bulkmail&controller=bulkmail' ), 'bm_initiated' );
}
}
/**
* Send Mandrill bulk mails immediately
*
* @return void
*/
public function sendMandrill()
{
/* If we are "continuing" an existing bulk mail send, update the task first */
if( isset( \IPS\Request::i()->resetTask ) AND \IPS\Request::i()->resetTask == 1 )
{
\IPS\core\BulkMail\Bulkmailer::updateTask();
}
\IPS\Output::i()->title = \IPS\Member::loggedIn()->language()->addToStack('bm_initiated');
\IPS\Output::i()->output = new \IPS\Helpers\MultipleRedirect(
\IPS\Http\Url::internal( "app=core&module=bulkmail&controller=bulkmail&do=sendMandrill&id=" . intval( \IPS\Request::i()->id ) ),
function( $data )
{
/* Retrieve the bulk mail details */
try
{
$mail = \IPS\core\BulkMail\Bulkmailer::load( (int) \IPS\Request::i()->id, NULL, 'mail_active=1' );
}
catch( \OutOfRangeException $e )
{
return NULL;
}
/* On first cycle return data */
if ( !is_array( $data ) )
{
return array( array( 'total' => $mail->getQuery()->count( TRUE ), 'done' => 0 ),
\IPS\Member::loggedIn()->language()->addToStack('bulkmail_sent_sofar', FALSE, array( 'sprintf' => array( $mail->subject, \IPS\Member::loggedIn()->language()->addToStack( 'bm_users', FALSE, array( 'pluralize' => array( 0 ) ) ) ) ) ),
1
);
}
/* Send the bulk mail */
$result = $mail->send();
/* If response is NULL there were no recipients. If response is 0 no emails were sent. Either way we're done. */
if( $result === NULL OR $result === 0 )
{
return NULL;
}
else
{
$data['done'] += (int) $result;
return array( $data,
\IPS\Member::loggedIn()->language()->addToStack('bulkmail_sent_sofar', FALSE, array( 'sprintf' => array( $mail->subject, \IPS\Member::loggedIn()->language()->addToStack( 'bm_users', FALSE, array( 'pluralize' => array( $result ) ) ) ) ) ),
( $result / $data['total'] * $data['done'] )
);
}
},
function()
{
/* We don't have to do anything special because BulkMailer will have already updated the task and disabled the bulk mail */
\IPS\Output::i()->redirect( \IPS\Http\Url::internal( 'app=core&module=bulkmail&controller=bulkmail' ), 'bm_mandrill_sent' );
}
);
}
/**
* Add or edit a bulk mail
*
* @return void
*/
public function form()
{
/* Are we editing? */
$mail = array( '_options' => array() );
if( (int) \IPS\Request::i()->id )
{
/* Retrieve the bulk mail details */
try
{
$mail = \IPS\core\BulkMail\Bulkmailer::load( (int) \IPS\Request::i()->id );
}
catch( \OutOfRangeException $e )
{
\IPS\Output::i()->error( 'couldnt_find_bulkmail', '2C125/6', 404, '' );
}
}
else
{
$mail = new \IPS\core\BulkMail\Bulkmailer;
}
/* Get tags */
$tags = \IPS\core\BulkMail\Bulkmailer::getTags();
/* Start the form */
$form = new \IPS\Helpers\Form;
$form->class = 'ipsForm_vertical';
$form->addtab( 'bulkmail__main' );
$form->add( new \IPS\Helpers\Form\Text( 'mail_subject', $mail->subject, TRUE ) );
$form->add( new \IPS\Helpers\Form\Editor( 'mail_body', $mail->content ?: "<p>{member_name},</p><p>&nbsp;</p>", TRUE, array( 'app' => 'core', 'key' => 'Admin', 'autoSaveKey' => 'bulkmail' . ( $mail->id ? '-' . $mail->id : '' ), 'tags' => $tags, 'attachIds' => array( $mail->id, NULL, 'bulkmail' ) ) ) );
if( \IPS\Settings::i()->mandrill_api_key AND \IPS\Settings::i()->mandrill_use_for )
{
$form->add( new \IPS\Helpers\Form\Stack( 'mandrill_tags', ( !empty( $mail->_options['mandrill_tags'] ) ) ? $mail->_options['mandrill_tags'] : array(), FALSE ) );
}
/* Add the filters tab and the "generic filters" header */
$form->addtab( 'bulkmail__filters' );
$form->addHeader( 'generic_bm_filters' );
$lastApp = 'core';
/* Now grab bulk mail extensions */
foreach ( \IPS\Application::allExtensions( 'core', 'BulkMail', TRUE, 'core' ) as $key => $extension )
{
if( method_exists( $extension, 'getSettingField' ) )
{
/* See if we need a new form header - one per app */
$_key = explode( '_', $key );
if( $_key[0] != $lastApp )
{
$lastApp = $_key[0];
$form->addHeader( $lastApp . '_bm_filters' );
}
/* Grab our fields and add to the form */
$fields = $extension->getSettingField( !empty( $mail->_options[ $key ] ) ? $mail->_options[ $key ] : array() );
foreach( $fields as $field )
{
$form->add( $field );
}
}
}
/* Handle submissions */
if ( $values = $form->values() )
{
$mail->subject = $values['mail_subject'];
$mail->content = $values['mail_body'];
$mail->updated = 0;
$mail->start = 0;
$mail->sentto = 0;
$mail->active = 0;
$_options = array();
if( \IPS\Settings::i()->mandrill_api_key AND \IPS\Settings::i()->mandrill_use_for )
{
$_options['mandrill_tags'] = $values['mandrill_tags'];
}
/* Loop over bulk mail extensions to format the options */
foreach ( \IPS\Application::allExtensions( 'core', 'BulkMail', TRUE, 'core' ) as $key => $extension )
{
if( method_exists( $extension, 'save' ) )
{
/* Grab our fields and add to the form */
$_value = $extension->save( $values );
if( $_value )
{
$_options[ $key ] = $_value;
}
}
}
$mail->_options = $_options;
if ( !empty( $mail->id ) )
{
$mail->save();
\IPS\Session::i()->log( 'acplogs__bulkmail_edited', array( $mail->subject => FALSE ) );
}
else
{
$mail->save();
\IPS\Session::i()->log( 'acplogs__bulkmail_added', array( $mail->subject => FALSE ) );
}
\IPS\Output::i()->redirect( \IPS\Http\Url::internal( 'app=core&module=bulkmail&controller=bulkmail&do=preview&id=' . $mail->id ), 'saved' );
}
/* Output */
\IPS\Output::i()->title = \IPS\Member::loggedIn()->language()->addToStack('mail_configuration');
\IPS\Output::i()->output = \IPS\Theme::i()->getTemplate( 'global' )->message( 'unsubscribed_users_mail', 'information' );
\IPS\Output::i()->output .= \IPS\Theme::i()->getTemplate( 'global' )->block( 'mail_configuration', $form );
}
}