Changeset 8605

Timestamp:

04/08/2019 04:39:52 AM (7 years ago)

Author:

dd32

Message:

WordCamp Attendance UI: Allow organisers to select additional Ticket Questions to be shown on the Check in UI.

For example, This allows a WordCamp to show the answer to the 'T Shirt Size' question to help the registration team find the correct swag for the attendee.

This also includes any Attendee Flags set (eg 'Speaker' or 'Food Allergy') to help the registration team find badges or give them any extra relevant information required.

Screenshot example: ​https://cloudup.com/ckqnh2PVeI8

See ​https://github.com/WordPress/wordcamp.org/pull/61.

Location:

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

Files:

• camptix-admin-flags/addons/admin-flags.php (modified) (2 diffs)
• camptix-attendance/addons/assets/attendance-ui.css (modified) (1 diff)
• camptix-attendance/addons/assets/attendance-ui.js (modified) (2 diffs)
• camptix-attendance/addons/assets/attendance-ui.scss (modified) (1 diff)
• camptix-attendance/addons/attendance-ui.php (modified) (1 diff)
• camptix-attendance/addons/attendance.php (modified) (6 diffs)

sites/trunk/wordcamp.org/public_html/wp-content/plugins/camptix-admin-flags/addons/admin-flags.php

@@ -64 +64 @@
         add_filter( 'shortcode_atts_camptix_attendees', array( $this, 'shortcode_attendees_atts' ), 10, 3 );
         add_filter( 'camptix_attendees_shortcode_query_args', array( $this, 'shortcode_attendees_query' ), 10, 2 );
+
+        // Add the Flags to the Attendance UI.
+        add_filter( 'camptix_attendance_ui_extras', array( $this, 'attendance_ui_extras' ), 10, 2 );
     }
 
@@ -410 +413 @@
         );
     }
+
+    /**
+     * Register Admin flags to be shown in the Attendance UI.
+     *
+     * @param array   $extras   List of 'Extra fields' to show.
+     * @param WP_Post $attendee The Attendee WP_Post being displayed.
+     */
+    public function attendance_ui_extras( $extras, $attendee ) {
+        $attendee_flags = (array) get_post_meta( $attendee->ID, 'camptix-admin-flag' );
+
+        $flags = array();
+        foreach ( $attendee_flags as $flag ) {
+            if ( isset( $this->flags[ $flag ] ) ) {
+                $flags[] = $this->flags[ $flag ];
+            }
+        }
+
+        if ( $flags ) {
+            array_unshift(
+                $extras,
+                array( implode( ', ', $flags ) )
+            );
+        }
+
+        return $extras;
+    }
+
 
     /**

sites/trunk/wordcamp.org/public_html/wp-content/plugins/camptix-attendance/addons/assets/attendance-ui.css

@@ -293 +293 @@
     display: block;
     width: 200px;
-    margin: 40px auto 0 auto; }
+    margin: 40px auto 40px auto; }
   .attendee-toggle-wrap a.yes,
   .attendee-toggle-wrap a.no {

sites/trunk/wordcamp.org/public_html/wp-content/plugins/camptix-attendance/addons/assets/attendance-ui.js

@@ -20 +20 @@
                 avatar: '',
                 firstName: '',
-                lastName: ''
+                lastName: '',
+                extras: []
             }
         },
@@ -177 +178 @@
             this.$el.addClass( 'camptix-loading' );
         },
-        
+
         /**
          * Hide the spinner.

sites/trunk/wordcamp.org/public_html/wp-content/plugins/camptix-attendance/addons/assets/attendance-ui.scss

@@ -373 +373 @@
         display: block;
         width: 200px;
-        margin: 40px auto 0 auto;
+        margin: 40px auto 40px auto;
     }
 

sites/trunk/wordcamp.org/public_html/wp-content/plugins/camptix-attendance/addons/attendance-ui.php

@@ -44 +44 @@
             <a href="#" class="yes">Yes</a>
             <a href="#" class="no">No</a>
+        </div>
+
+        <div class="extras">
+             <# for ( var i in data.extras ) {
+                var item = data.extras[i];
+                if ( item.length > 1 ) { #>
+                    <strong>{{ item[0] }}:</strong> {{ item[1] }}<br>
+                <# } else { #>
+                    {{ item[0] }}<br>
+                <# } #>
+             <# } #>
         </div>
 

sites/trunk/wordcamp.org/public_html/wp-content/plugins/camptix-attendance/addons/attendance.php

@@ -4 +4 @@
  */
 class CampTix_Attendance extends CampTix_Addon {
+    public $secret    = '';
+    public $questions = array();
     /**
      * Runs during CampTix init.
@@ -22 +24 @@
 
         $this->secret = $camptix_options['attendance-secret'];
+
+        if ( isset( $camptix_options['attendance-questions'] ) ) {
+            $this->questions = $camptix_options['attendance-questions'];
+        }
 
         if ( empty( $camptix_options['attendance-enabled'] ) )
@@ -202 +208 @@
         $status = (bool) get_post_meta( $attendee->ID, 'tix_attended', true );
 
+        $extras = array();
+
+        // By default, allow certain questions to be included.
+        $questions = get_post_meta( $attendee->ID, 'tix_questions', true );
+        foreach ( $this->questions as $question_id ) {
+            if ( ! isset( $questions[ $question_id ] ) ) {
+                continue;
+            }
+
+            $question_post = get_post( $question_id );
+            $extras[] = [
+                html_entity_decode( apply_filters( 'the_title', $question_post->post_title ) ), // Escaped on display
+                // The attendees selection, which may be an array.
+                is_array( $questions[ $question_id ] ) ? implode( ', ', $questions[ $question_id ] ) : $questions[ $question_id ],
+            ];
+        }
+
+        /**
+         * Allow other plugins/Camptix Addons to register extra fields.
+         */
+        $extras = apply_filters( 'camptix_attendance_ui_extras', $extras, $attendee );
+
         return array(
-            'id' => $attendee->ID,
+            'id'        => $attendee->ID,
             'firstName' => $first_name,
-            'lastName' => $last_name,
-            'avatar' => esc_url_raw( $avatar_url ),
-            'status' => $status,
+            'lastName'  => $last_name,
+            'avatar'    => esc_url_raw( $avatar_url ),
+            'status'    => $status,
+            'extras'    => $extras,
         );
     }
@@ -292 +321 @@
             esc_html__( "Don't forget to disable the UI after the event is over.", 'wordcamporg' )
         );
+
+        add_settings_field( 'attendance-questions', esc_html__( 'Questions', 'wordcamporg' ), array( $this, 'field_questions' ), 'camptix_options', 'general', esc_html__( 'Show these additional ticket questions in the UI.', 'wordcamporg' ) );
 
         add_settings_field( 'attendance-secret', esc_html__( 'Secret Link', 'wordcamporg' ), array( $this, 'field_secret' ), 'camptix_options', 'general' );
@@ -314 +345 @@
 
     /**
+     * Ticket Questions Field
+     *
+     * This is a field that allows selection of any of the Ticket Questions specified
+     * to be output into the Attendance UI.
+     */
+    public function field_questions() {
+        global $camptix;
+        $questions = $camptix->get_all_questions();
+
+        echo '<p>' . esc_html__( 'Show the following ticket questions in the Attendance UI.', 'wordcamporg' ) . '</p>';
+
+        foreach ( $questions as $question ) {
+            $selections = get_post_meta( $question->ID, 'tix_values', true );
+            printf(
+                '<label><input type="checkbox" name="camptix_options[attendance-questions][]" value="%s" %s> %s %s</label><br>',
+                esc_attr( $question->ID ),
+                checked( in_array( $question->ID, $this->questions, true ), true, false ),
+                esc_html( apply_filters( 'the_title', $question->post_title ) ),
+                $selections ? '<em>' . esc_html( implode( ', ', $selections ) ) . '</em>' : ''
+            );
+        }
+
+    }
+
+    /**
      * Setup section description.
      */
@@ -333 +389 @@
         if ( ! empty( $input['attendance-generate'] ) )
             $output['attendance-secret'] = wp_generate_password( 32, false, false );
+
+        if ( ! empty( $input['attendance-questions'] ) ) {
+            $output['attendance-questions'] = array_map( 'intval', $input['attendance-questions'] );
+        } elseif ( isset( $input['attendance-enabled'] ) ) {
+            $output['attendance-questions'] = array();
+        }
 
         return $output;