Changeset 8083

Timestamp:

01/15/2019 09:06:15 AM (6 years ago)

Author:

vedjain

Message:

WCPT: Send notifications to community-events or community-team slack channel on status changes in WordCamp/Meetup applications

Whenever a WordCamp/Meetup application is received, accepted or declined, we will send out notifications. This will help in surfacing interesting changes happening in the community.
This is also discussed in ​https://make.wordpress.org/community/2018/12/24/slack-notifications-for-wordcamp-and-meetup-application-updates/

Location:

sites/trunk/wordcamp.org/public_html/wp-content/plugins/wcpt

Files:

• wcpt-event/class-event-admin.php (modified) (2 diffs)
• wcpt-event/class-event-application.php (modified) (6 diffs)
• wcpt-event/notification.php (added)
• wcpt-loader.php (modified) (1 diff)
• wcpt-meetup/class-meetup-admin.php (modified) (2 diffs)
• wcpt-meetup/class-meetup-application.php (modified) (1 diff)
• wcpt-meetup/meetup.php (modified) (1 diff)
• wcpt-wordcamp/class-wordcamp-application.php (modified) (5 diffs)
• wcpt-wordcamp/wordcamp-admin.php (modified) (2 diffs)

sites/trunk/wordcamp.org/public_html/wp-content/plugins/wcpt/wcpt-event/class-event-admin.php

@@ -56 +56 @@
         add_action( 'transition_post_status', array( $this, 'log_status_changes' ), 10, 3 );
 
+        add_action( 'transition_post_status', array( $this, 'notify_application_status_in_slack' ), 10, 3 );
+
         add_filter( 'redirect_post_location', array( $this, 'add_admin_notices_to_redirect_url' ), 10, 2 );
 
         // Admin notices
         add_action( 'admin_notices', array( $this, 'print_admin_notices' ) );
+
+        add_action( 'send_decline_notification_action',  'Event_Admin::send_decline_notification', 10, 3 );
+
     }
 
@@ -275 +280 @@
             add_post_meta( $post->ID, "_status_change_log_$post->post_type $log_id", time() );
         }
+    }
+
+    /**
+     * Hooked to `transition_post_status`, will send notifications to community slack channels based whenever an application status changes to something that we are interested in. Most likely would be when an application is declined or accepted.
+     *
+     * @param string  $new_status New status
+     * @param string  $old_status Old Status
+     * @param WP_Post $event
+     */
+    abstract public function notify_application_status_in_slack( $new_status, $old_status, WP_Post $event );
+
+    /**
+     * Schedule notificaiton for declined application. Currently supports WordCamp and Meetup
+     *
+     * @param WP_Post $event Event object
+     * @param string  $label Could be WordCamp or Meetup
+     * @param string  $location
+     *
+     * @return bool|string
+     */
+    public static function schedule_decline_notification( $event, $label, $location ) {
+        wp_schedule_single_event( time() + DAY_IN_SECONDS, 'send_decline_notification_action', array( $event->ID, $label, $location ) );
+    }
+
+    /**
+     * Send declined notification to community team slack channel.
+     *
+     * @param int    $event_id
+     * @param string $label
+     * @param string $location
+     */
+    public static function send_decline_notification( $event_id, $label, $location ) {
+        $message = sprintf(
+            "A %s application for %s has been declined, and the applicant has been informed via email.",
+            $label,
+            $location
+        );
+
+        $attachment = create_event_status_attachment( $message, $event_id, '' );
+        wcpt_slack_notify( COMMUNITY_TEAM_SLACK, $attachment );
     }
 

sites/trunk/wordcamp.org/public_html/wp-content/plugins/wcpt/wcpt-event/class-event-application.php

@@ -7 +7 @@
 
 namespace WordPress_Community\Applications;
+require_once WCPT_DIR . 'wcpt-event/notification.php';
 
 /**
@@ -85 +86 @@
     public function submit_application() {
         $application_data = $this->validate_data( $_POST );
+
         if ( $this->is_rate_limited() ) {
             $message        = __( 'You have submitted too many applications recently. Please wait and try again in a few hours.', 'wordcamporg' );
@@ -93 +95 @@
         } else {
             $this->create_post( $application_data );
-            $this->notify_applicant_application_received( $this->get_organizer_email(), $this->get_event_location() );
+            $this->notify_applicant_application_received(
+                    $this->get_organizer_email(),
+                    $this->get_event_location()
+            );
+
+            $this->notify_new_application_in_slack();
+
             $message        = __( "Thank you for your application! We've received it, and we'll contact you once we've had a chance to review it.", 'wordcamporg' );
             $notice_classes = 'notice-success';
@@ -175 +183 @@
 
     /**
+     * Get default status for a new application.
+     *
+     * @return string|null
+     */
+    abstract public static function get_default_status();
+
+    /**
+     * Get publicly accessible report url for a event. Should return null if such report is published.
+     *
+     * @return string|null
+     */
+    abstract public static function get_application_report_url();
+
+    /**
      * Display a notice to applicant while submitting the form.
      *
@@ -192 +214 @@
      *
      * @param string $email_address
-     * @param string $meetup_city
-     */
-    public function notify_applicant_application_received( $email_address, $meetup_city ) {
+     * @param string $event_city
+     */
+    public function notify_applicant_application_received( $email_address, $event_city ) {
         //translators: Name of the event. Egs WordCamp.
         $subject = sprintf( __( "We've received your %s application", 'wpct' ), $this->get_event_label() );
@@ -204 +226 @@
                 'wpct'
             ),
-            $this->get_event_label(), sanitize_text_field( $meetup_city )
+            $this->get_event_label(), sanitize_text_field( $event_city )
         );
 
         wp_mail( $email_address, $subject, $message, $headers );
     }
+
+    /**
+     * Notify in community slack channel that we've received an application
+     */
+    public function notify_new_application_in_slack() {
+
+        // Not translating because this will be sent to community events slack channel.
+        $message = sprintf( "A %s application for %s has been received.", $this->get_event_label(), $this->get_event_location() );
+
+        $public_report_url = $this->get_application_report_url();
+        if ( isset( $public_report_url ) ) {
+            // `<%s|here> is syntax for slack message to hyperlink text `here` with url provided in `%s`
+            $message = sprintf( "%s Public status can be followed on <%s|%s application report page>.", $message, $public_report_url, $this->get_event_label() );
+        }
+
+        $default_status = $this->get_default_status();
+        $queue_size = wp_count_posts( $post_type=$this->get_event_type() )->$default_status;
+        if ( isset( $queue_size ) ) {
+            $singular = "is $queue_size application";
+            $plural   = "are $queue_size applications";
+            $message = sprintf(
+                    "%s\n _There %s in vetting queue._",
+                    $message,
+                    1 === $queue_size ? $singular : $plural );
+        }
+
+        $attachment = create_event_attachment( $message,  sprintf( "New %s application ", $this->get_event_label() ) );
+        return wcpt_slack_notify( COMMUNITY_TEAM_SLACK, $attachment );
+    }
 }

sites/trunk/wordcamp.org/public_html/wp-content/plugins/wcpt/wcpt-loader.php

@@ -51 +51 @@
         require_once ( WCPT_DIR . 'wcpt-meetup/meetup.php' );
         require_once ( WCPT_DIR . 'wcpt-meetup/class-meetup-admin.php' );
+        require_once ( WCPT_DIR . 'wcpt-event/class-event-admin.php' ); // required for declined application cron to work.
 
         // Require admin files.

sites/trunk/wordcamp.org/public_html/wp-content/plugins/wcpt/wcpt-meetup/class-meetup-admin.php

@@ -9 +9 @@
 
 require_once WCPT_DIR . 'wcpt-event/class-event-admin.php';
-
-if ( ! class_exists( 'MeetupAdmin' ) ) :
+require_once WCPT_DIR . 'wcpt-event/notification.php';
+
+
+if ( ! class_exists( 'Meetup_Admin' ) ) :
 
     /**
@@ -477 +479 @@
             $this->update_meetup_organizers( $organizers_list, $post );
 
+        }
+
+        /**
+         * Send notification to slack when a Meetup becomes active in the chapter or is declined.
+         *
+         * @param string  $new_status
+         * @param string  $old_status
+         * @param WP_Post $meetup
+         *
+         * @return null|bool Will be null if notification was not enabled, or false if notifcation was attempted but failed. true if notification was successful
+         */
+        public function notify_application_status_in_slack( $new_status, $old_status, WP_Post $meetup ) {
+
+            $notification_enabled = apply_filters( 'meetup_application_notification_enabled', true );
+
+            if ( ! $notification_enabled ) {
+                return null;
+            }
+
+            if ( 'wcpt-mtp-active' === $new_status ) {
+                return $this->notify_new_meetup_group_in_slack( $meetup );
+            } elseif ( 'wcpt-mtp-rejected' === $new_status ) {
+                $location = get_post_meta( $meetup->ID, 'Meetup Location', true );
+                return $this->schedule_decline_notification( $meetup, $this->get_event_label(), $location );
+            }
+        }
+
+        /**
+         * Send notification when a new Meetup groups is added to the chapter.
+         *
+         * @param WP_Post $meetup Meetup post object
+         *
+         * @return bool|string
+         */
+        public static function notify_new_meetup_group_in_slack( $meetup ) {
+
+            // Not translating strings here because these will be sent to Slack.
+            $city            = get_post_meta( $meetup->ID, 'Meetup Location', true );
+            $organizer_slack = get_post_meta( $meetup->ID, 'Slack', true );
+            $meetup_link     = get_post_meta( $meetup->ID, 'Meetup URL', true );
+            $title           = "New meetup group added";
+
+            $message = sprintf(
+                "Let's welcome the new WordPress meetup group%s%s, to the chapter! :tada: :community: :wordpress:\n%s",
+                isset( $city ) ? " in $city," : "",
+                isset( $organizer_slack ) ? " organized by @$organizer_slack" : "",
+                $meetup_link
+            );
+
+            $attachment = create_event_status_attachment( $message, $meetup->ID, $title );
+
+            return wcpt_slack_notify( COMMUNITY_EVENTS_SLACK, $attachment );
         }
 

sites/trunk/wordcamp.org/public_html/wp-content/plugins/wcpt/wcpt-meetup/class-meetup-application.php

@@ -271 +271 @@
     public function get_event_location() {
         if ( isset( $this->post->ID ) ) {
-            return get_post_meta( $this->post->ID, 'q_city', true );
-        }
+            return get_post_meta( $this->post->ID, 'Meetup Location', true );
+        }
+    }
+
+    /**
+     * Public report URL for Meetup Applications
+     */
+    public static function get_application_report_url() {
+        return "https://central.wordcamp.org/reports/meetup-applications/";
     }
 

sites/trunk/wordcamp.org/public_html/wp-content/plugins/wcpt/wcpt-meetup/meetup.php

@@ -3 +3 @@
 namespace WordPress_Community\Applications\Meetup;
 
-require_once 'class-meetup-application.php';
+require_once WCPT_DIR . 'wcpt-meetup/class-meetup-application.php';
 use WordPress_Community\Applications\Meetup_Application;
 

sites/trunk/wordcamp.org/public_html/wp-content/plugins/wcpt/wcpt-wordcamp/class-wordcamp-application.php

@@ -15 +15 @@
 
     static function get_event_label() {
-        __( 'WordCamp', 'wordcamporg' );
+        return __( 'WordCamp', 'wordcamporg' );
     }
 
@@ -158 +158 @@
 
     /**
+     * Gets default status of new WordCamp application
+     *
+     * @return string
+     */
+    public static function get_default_status() {
+        return WCPT_DEFAULT_STATUS;
+    }
+
+    /**
+     * Public report URL for WordCamp applications.
+     *
+     * @return string
+     */
+    public static function get_application_report_url() {
+        return "https://central.wordcamp.org/reports/application-status/";
+    }
+
+    /**
      * Create a WordCamp post from an application
      *
@@ -186 +204 @@
         add_post_meta( $post_id, '_application_data', $data );
         add_post_meta( $post_id, '_application_submitter_ip_address', $_SERVER['REMOTE_ADDR'] );
+
 
         add_post_meta(
@@ -231 +250 @@
     function get_organizer_email() {
         if ( isset( $this->post ) && isset( $this->post->ID ) ) {
-            return get_post_meta( $this->post->ID, 'q_1079059_email' );
+            return get_post_meta( $this->post->ID, 'Email Address', true );
         }
     }
@@ -242 +261 @@
     function get_event_location() {
         if ( isset( $this->post ) && isset( $this->post->ID ) ) {
-            return get_post_meta( $this->post->ID, 'q_1079103_wordcamp_location' );
+            return get_post_meta( $this->post->ID, 'Location', true );
         }
     }

sites/trunk/wordcamp.org/public_html/wp-content/plugins/wcpt/wcpt-wordcamp/wordcamp-admin.php

@@ -6 +6 @@
 
 require_once WCPT_DIR . 'wcpt-event/class-event-admin.php';
+require_once WCPT_DIR . 'wcpt-event/notification.php';
 
 if ( ! class_exists( 'WordCamp_Admin' ) ) :
@@ -708 +709 @@
 
         /**
+         * Send notification to slack when a WordCamp is scheduled or declined. Runs whenever status of an applications changes
+         *
+         * @param string  $new_status
+         * @param string  $old_status
+         * @param WP_Post $wordcamp
+         *
+         * @return null|bool
+         */
+        public function notify_application_status_in_slack( $new_status, $old_status, WP_Post $wordcamp ) {
+
+            $notification_enabled = apply_filters( 'wordcamp_application_notification_enabled', true );
+
+            if ( ! $notification_enabled ) {
+                return null;
+            }
+
+            if ( 'wcpt-scheduled' === $new_status ) {
+                return $this->notify_new_wordcamp_in_slack( $wordcamp );
+            } elseif ( 'wcpt-rejected' === $new_status ) {
+                $location = get_post_meta( $wordcamp->ID, 'Location', true );
+                return $this->schedule_decline_notification( $wordcamp, 'WordCamp', $location );
+            }
+        }
+
+        /**
+         * Send notification when a new WordCamp comes in scheduled status.
+         *
+         * @param WP_Post $wordcamp
+         *
+         * @return null|bool
+         */
+        public static function notify_new_wordcamp_in_slack( $wordcamp ) {
+            // Not translating any string because they will be sent to slack.
+            $city             = get_post_meta( $wordcamp->ID, 'Location', true );
+            $start_date       = get_post_meta( $wordcamp->ID, 'Start Date (YYYY-mm-dd)', true );
+            $wordcamp_url     = get_post_meta( $wordcamp->ID, 'URL', true );
+            $title            = 'New WordCamp scheduled!!!';
+
+            $message = sprintf(
+                "<%s|WordCamp $city> has been scheduled for a start date of %s. :tada: :community: :wordpress:\n\n%s",
+                $wordcamp_url,
+                date( 'F j, Y', $start_date ),
+                $wordcamp_url
+            );
+
+            $attachment = create_event_status_attachment( $message, $wordcamp->ID, $title );
+
+            return wcpt_slack_notify( COMMUNITY_EVENTS_SLACK, $attachment );
+        }
+
+        /**
          * Enforce a valid post status for WordCamps.
          *