Changeset 3119

Timestamp:

05/11/2016 11:21:02 PM (8 years ago)

Author:

iandunn

Message:

WordCamp Budgets: Attach a PDF copy of the invoice to the notification email.

Location:

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

Files:

• wordcamp-payments-network/includes/sponsor-invoices-dashboard.php (modified) (3 diffs)
• wordcamp-qbo-client/wordcamp-qbo-client.php (modified) (1 diff)
• wordcamp-qbo/wordcamp-qbo.php (modified) (2 diffs)

sites/trunk/wordcamp.org/public_html/wp-content/plugins/wordcamp-payments-network/includes/sponsor-invoices-dashboard.php

@@ -323 +323 @@
     $invoice_url  = admin_url( sprintf( 'post.php?post=%s&action=edit', $invoice_id ) );
     $headers      = array( 'Reply-To: support@wordcamp.org' );
+    $attachments  = array();
+    $attachment_message = '';
+    $invoice_filename = false;
+    // todo realign
 
     if ( 'approved' === $new_status ) {
@@ -328 +332 @@
         $sponsor_email  = get_post_meta( $sponsor_id, '_wcpt_sponsor_email_address',  true );
         $status_message = "has been sent to $sponsor_name via $sponsor_email. You will receive another notification when they have paid the invoice.";
+        $qbo_invoice_id   = get_post_meta( $invoice_id, '_wcbsi_qbo_invoice_id', true );
+        $invoice_filename = \WordCamp_QBO_Client::get_invoice_filename( $qbo_invoice_id );
+        // todo realign
+
+        if ( ! is_wp_error( $invoice_filename ) ) {
+            $attachments[]      = $invoice_filename;
+            $attachment_message = "\nA copy of the invoice has been attached to this message, in case you need to follow up with the sponsor.";
+        }
     } elseif ( 'paid' === $new_status ) {
         $status_message = "has been paid by $sponsor_name. Go ahead and publish them to your website!";
@@ -340 +352 @@
 
         $invoice_url
+        $attachment_message
 
         If you have any questions, please reply to let us know."
     );
 
-    wp_mail( $to, $subject, $message, $headers );
+    wp_mail( $to, $subject, $message, $headers, $attachments );
+
+    if ( $invoice_filename ) {
+        unlink( $invoice_filename );
+    }
 
     restore_current_blog();

sites/trunk/wordcamp.org/public_html/wp-content/plugins/wordcamp-qbo-client/wordcamp-qbo-client.php

@@ -434 +434 @@
 
     /**
+     * Get the filename for a PDF copy of an invoice
+     *
+     * @param int $invoice_id
+     *
+     * @return WP_Error|string
+     */
+    public static function get_invoice_filename( $invoice_id ) {
+        $request  = self::build_invoice_filename_request( $invoice_id );
+        $response = wp_remote_get( $request['url'], $request['args'] );
+
+        if ( is_wp_error( $response ) ) {
+            $result = $response;
+        } else {
+            $result = json_decode( wp_remote_retrieve_body( $response ) );
+
+            if ( $result && is_file( $result->filename ) ) {
+                $result = $result->filename;
+            } else {
+                $result = new WP_Error( 'invalid_filename', 'The filename was not valid.', $result );
+            }
+        }
+
+        return $result;
+    }
+
+    /**
+     * Build the request to get the filename for a PDF copy of an invoice
+     *
+     * @param array $invoice_ids
+     *
+     * @return array
+     */
+    protected static function build_invoice_filename_request( $invoice_id ) {
+        $params = array(
+            'invoice_id' => strval( absint( $invoice_id ) ),    // absint() to validate, strval() to convert to type expected by API
+        );
+
+        $request_url = self::$api_base . '/invoice_pdf';
+
+        $args = array(
+            'headers' => array(
+                'Authorization' => self::_get_auth_header( 'get', $request_url, '', $params ),
+                'Content-Type'  => 'application/json',
+            ),
+        );
+
+        $request_url = add_query_arg( $params, $request_url );  // has to be done after get_auth_header() is called so that the base url and params can be passed separately
+
+        return array(
+            'url'  => $request_url,
+            'args' => $args,
+        );
+    }
+
+    /**
      * Create an HMAC signature header for a request.
      *

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

@@ -90 +90 @@
             'methods' => 'GET, POST',
             'callback' => array( __CLASS__, 'rest_callback_invoice' ),
+        ) );
+
+        register_rest_route( 'wordcamp-qbo/v1', '/invoice_pdf', array(
+            'methods' => 'GET',
+            'callback' => array( __CLASS__, 'rest_callback_invoice_pdf' ),
         ) );
 
@@ -595 +600 @@
 
     /**
+     * REST: /invoice_pdf
+     *
+     * Saves a PDF copy of the invoice and returns the filename
+     *
+     * Note: The function that eventually ends up using the file should delete it once it's done with it.
+     *
+     * @param WP_REST_Request $request
+     *
+     * @return string|WP_Error The filename on success, or a WP_Error on failure
+     */
+    public static function rest_callback_invoice_pdf( $request ) {
+        if ( ! self::_is_valid_request( $request ) ) {
+            return new WP_Error( 'unauthorized', 'Unauthorized', array( 'status' => 401 ) );
+        }
+
+        $qbo_request = self::build_qbo_get_invoice_pdf_request( $request->get_param( 'invoice_id' ) );
+        $response    = wp_remote_get( $qbo_request['url'], $qbo_request['args'] );
+
+        if ( is_wp_error( $response ) ) {
+            $result = $response;
+        } elseif ( 200 != wp_remote_retrieve_response_code( $response ) ) {
+            $result = new WP_Error( 'invalid_http_code', 'Invalid HTTP response code', $response );
+        } else {
+            $body             = wp_remote_retrieve_body( $response );
+            $valid_pdf_header = '%PDF-' === substr( $body, 0, 5 );
+            $valid_pdf_footer = '%%EOF' === substr( $body, strlen( $body ) - 7, 5 );
+
+            if ( $valid_pdf_header && $valid_pdf_footer ) {
+                $filename = sprintf(
+                    '%sWPCS-invoice-%d.pdf',
+                    get_temp_dir(),
+                    $request->get_param( 'invoice_id' )
+                );
+
+                if ( file_put_contents( $filename, $body ) ) {
+                    $result = array( 'filename' => $filename );
+                } else {
+                    $result = new WP_Error( 'write_error', 'Failed writing PDF to disk.', compact( 'filename', 'body' ) );
+                }
+            } else {
+                $result = new WP_Error( 'invalid_body', 'Response body was not a PDF.', $response );
+            }
+        }
+
+        return $result;
+    }
+
+    /**
+     * Build a request to send an Invoice via QuickBook's API
+     *
+     * @param int $invoice_id
+     *
+     * @return array
+     */
+    protected static function build_qbo_get_invoice_pdf_request( $invoice_id ) {
+        self::load_options();
+        $oauth = self::_get_oauth();
+        $oauth->set_token( self::$options['auth']['oauth_token'], self::$options['auth']['oauth_token_secret'] );
+
+        $request_url = sprintf(
+            '%s/v3/company/%d/invoice/%d/pdf',
+            self::$api_base_url,
+            rawurlencode( self::$options['auth']['realmId'] ),
+            rawurlencode( $invoice_id )
+        );
+
+        $args = array(
+            'timeout' => self::REMOTE_REQUEST_TIMEOUT,
+            'headers' => array(
+                'Authorization' => $oauth->get_oauth_header( 'GET', $request_url ),
+                'Accept'        => 'application/pdf',
+                'Content-Type'  => 'application/pdf',
+            ),
+            'body' => '',
+        );
+
+        return array(
+            'url'  => $request_url,
+            'args' => $args,
+        );
+    }
+
+    /**
      * Notify Central that an invoice was created but couldn't be sent to the sponsor
      *