Changeset 10482 for trunk/src/bp-core/classes/class-bp-email.php

Timestamp:

01/30/2016 08:39:59 PM (11 years ago)

Author:

djpaul

Message:

Emails: new param for set_bcc|cc|to() to add to current values

The default behaviour remains to replace the current value.

This will allow plugin developers to easily append a new email
recipient without having to re-add the existing recipients.

See #6592

File:

• trunk/src/bp-core/classes/class-bp-email.php (modified) (9 diffs)

trunk/src/bp-core/classes/class-bp-email.php

@@ -522 +522 @@
          *                                              or an array containing any combination of the above.
          * @param string $name Optional. If $bcc_address is a string, this is the recipient's name.
-         * @return BP_Email
-         */
-        public function set_bcc( $bcc_address, $name = '' ) {
-                $bcc = array();
+         * @param string $operation Optional. If "replace", $to_address replaces current setting (default).
+         *                          If "add", $to_address is added to the current setting.
+         * @return BP_Email
+         */
+        public function set_bcc( $bcc_address, $name = '', $operation = 'replace' ) {
+                $bcc = ( $operation !== 'replace' ) ? $this->bcc : array();
 
                 if ( is_array( $bcc_address ) ) {
@@ -533 +535 @@
 
                 } else {
-                        $bcc = array( new BP_Email_Recipient( $bcc_address, $name ) );
+                        $bcc[] = new BP_Email_Recipient( $bcc_address, $name );
                 }
 
@@ -545 +547 @@
                  *                                              or an array containing any combination of the above.
                  * @param string $name Optional. If $bcc_address is a string, this is the recipient's name.
-                 * @param BP_Email $this Current instance of the email type class.
-                 */
-                $this->bcc = apply_filters( 'bp_email_set_bcc', $bcc, $bcc_address, $name, $this );
+                 * @param string $operation If "replace", $to_address replaced previous recipients. If "add",
+                 *                          $to_address was added to the array of recipients.
+                 * @param BP_Email $this Current instance of the email type class.
+                 */
+                $this->bcc = apply_filters( 'bp_email_set_bcc', $bcc, $bcc_address, $name, $operation, $this );
 
                 return $this;
@@ -566 +570 @@
          *                                             or an array containing any combination of the above.
          * @param string $name Optional. If $cc_address is a string, this is the recipient's name.
-         * @return BP_Email
-         */
-        public function set_cc( $cc_address, $name = '' ) {
-                $cc = array();
+         * @param string $operation Optional. If "replace", $to_address replaces current setting (default).
+         *                          If "add", $to_address is added to the current setting.
+         * @return BP_Email
+         */
+        public function set_cc( $cc_address, $name = '', $operation = 'replace' ) {
+                $cc = ( $operation !== 'replace' ) ? $this->cc : array();
 
                 if ( is_array( $cc_address ) ) {
@@ -577 +583 @@
 
                 } else {
-                        $cc = array( new BP_Email_Recipient( $cc_address, $name ) );
+                        $cc[] = new BP_Email_Recipient( $cc_address, $name );
                 }
 
@@ -589 +595 @@
                  *                                             or an array containing any combination of the above.
                  * @param string $name Optional. If $cc_address is a string, this is the recipient's name.
-                 * @param BP_Email $this Current instance of the email type class.
-                 */
-                $this->cc = apply_filters( 'bp_email_set_cc', $cc, $cc_address, $name, $this );
+                 * @param string $operation If "replace", $to_address replaced previous recipients. If "add",
+                 *                          $to_address was added to the array of recipients.
+                 * @param BP_Email $this Current instance of the email type class.
+                 */
+                $this->cc = apply_filters( 'bp_email_set_cc', $cc, $cc_address, $name, $operation, $this );
 
                 return $this;
@@ -834 +842 @@
          *                                             or an array containing any combination of the above.
          * @param string $name Optional. If $to_address is a string, this is the recipient's name.
-         * @return BP_Email
-         */
-        public function set_to( $to_address, $name = '' ) {
-                $to = array();
+         * @param string $operation Optional. If "replace", $to_address replaces current setting (default).
+         *                          If "add", $to_address is added to the current setting.
+         * @return BP_Email
+         */
+        public function set_to( $to_address, $name = '', $operation = 'replace' ) {
+                $to = ( $operation !== 'replace' ) ? $this->to : array();
 
                 if ( is_array( $to_address ) ) {
@@ -845 +855 @@
 
                 } else {
-                        $to = array( new BP_Email_Recipient( $to_address, $name ) );
+                        $to[] = new BP_Email_Recipient( $to_address, $name );
                 }
 
@@ -856 +866 @@
                  * @param string $to_address "To" address.
                  * @param string $name "To" name.
-                 * @param BP_Email $this Current instance of the email type class.
-                 */
-                $this->to = apply_filters( 'bp_email_set_to', $to, $to_address, $name, $this );
+                 * @param string $operation If "replace", $to_address replaced previous recipients. If "add",
+                 *                          $to_address was added to the array of recipients.
+                 * @param BP_Email $this Current instance of the email type class.
+                 */
+                $this->to = apply_filters( 'bp_email_set_to', $to, $to_address, $name, $operation, $this );
 
                 return $this;