Merge branch 'dev-1.1.1' into 'master'

update 1.1.1

See merge request iamapinan/woocommerce-line-notify!15

Author: apinandev

CHANGELOG

@@ -1,3 +1,15 @@
+v1.1.0
+- Change admin ui
+- Change class name duplicate.
+- Multi language support.
+- API
+- Add postcode shortcode.
+- Direct method
+- Debug option.
+- Dynamic fields
+- Dashboard widget
+- Can use without Woocommerce
+
 v1.0.9
 - Update meta
 v1.0.8

README.md

@@ -2,9 +2,24 @@
 Send woocommerce order notification to Line notify API.  
 You can customize message pattern and notify to your chat room or your chat group in your pattern.
 
-### [Download here](https://wordpress.org/plugins/woo-line-notify)
+---
+![Woocommerce Line Notify icon](src/image/download_button.png)   
+[https://wordpress.org/plugins/woo-line-notify](https://wordpress.org/plugins/woo-line-notify)
 
-## Available short code for implement message pattern.
+### Features
+1. Add line token.
+2. Message pattern with order short code supported.
+3. Send notify to line group or user.
+4. Send notify when have order activity.
+5. Multi language support.
+6. API to send message with basic authen security for developer.
+7. Static method to send message for developer.
+8. Debug mode option.
+9. Dynamic fields to unlock your need.
+10. Dashboard widget.
+11. Can use without Woocommerce.
+
+### Short code.
 ```
 [order_status]
 [order_id]
@@ -18,21 +33,102 @@ You can customize message pattern and notify to your chat room or your chat grou
 [order_note]
 [order_province]
 [order_url]
-[products] //List of product in order.
+[order_postcode]
+[products] <-- List of product in order.
+```
+
+### Dynamic shortcode
+```
+[shipping *]
+[billing *]
+[customer *]
+[order *]
+[meta *]
+```
+
+### Short code
+#### Customer Fields
+```	
+first_name	[custoemr first_name]
+last_name	[custoemr last_name]
+email	        [custoemr email]
+phone	        [custoemr phone]
+```
+
+#### Shipping fields
+```
+company	        [shipping company]
+address_1	[shipping address_1]
+address_2	[shipping address_2]
+city	        [shipping city]
+state	        [shipping state]
+postcode	[shipping postcode]
+country	        [shipping country]
+address_index	[shipping address_index]
 ```
 
-## Features
-- Add line token.
-- Message pattern with order short code supported.
-- Send notify to line group or user.
-- Send notify when have order activity.
-- Add logo or image banner to notification.
-- Only support Thai language for this version .
+#### Billing fields
+```
+company	        [billing company]
+address_1	[billing address_1]
+address_2	[billing address_2]
+city	        [billing city]
+state	        [billing state]
+postcode	[billing postcode]
+country	        [billing country]
+email	        [billing email]
+phone	        [billing phone]
+address_index	[billing address_index]
+```
+#### Order fields
+```
+order_key	        [order order_key]
+customer_user	        [order customer_user]
+payment_method	        [order payment_method]
+payment_method_title	[order payment_method_title]
+transaction_id	        [order transaction_id]
+customer_ip_address	[order customer_ip_address]
+customer_user_agent	[order customer_user_agent]
+created_via	        [order created_via]
+date_completed	        [order date_completed]
+completed_date	        [order completed_date]
+date_paid	        [order date_paid]
+paid_date	        [order paid_date]
+cart_hash	        [order cart_hash]
+order_currency	        [order order_currency]
+cart_discount	        [order cart_discount]
+cart_discount_tax	[order cart_discount_tax]
+order_shipping	        [order order_shipping]
+ordertax	        [order ordertax]
+order_tax	        [order order_tax]
+order_total	        [order order_total]
+order_version	        [order order_version]
+prices_include_tax	[order prices_include_tax]
+download_permissions_granted	[order download_permissions_granted]
+recorded_sales	        [order recorded_sales]
+recorded_coupon_usage_counts	[order recorded_coupon_usage_counts]
+order_stock_reduced	[order order_stock_reduced]
+edit_lock	        [order edit_lock]
+edit_last	        [order edit_last]
+```
+#### Meta
+Just use `[meta your_meta_name]` to take custom order meta by `get_post_meta()` function.
 
-## Benefits. 
-1. Send a notification to your self.
-2. Send a notifycation to your group.
-3. Can send text, image and line sticker to the notification message.
+### API for Developer
+To send message via static method just put your message to the method like below.
+```
+WooLineNotify::Send_Line_Notify( 'Some message to send' );
+```
+
+### REST API
+- URL: `domain/wp-json/woo-line-notify/v1/notify`  
+- METHOD: `POST`   
+- PARAMETERS: `message <Your message to send> ` 
+- Authentication: `Basic Authen`  
+- USERNAME/PASSWORD: `<API Key>:<API_Key>`
+
+#### For example.
+Send post request to `http://localhost/wp-json/woo-line-notify/v1/notify` you must be send parameter `message` by form/data and add Authenticate to header with value `Basic base64_encode( some_api_key_from_api_option:some_api_key_from_api_option )`
 
 ## How to install
 1. Upload the entire wc_linenotify folder to the /wp-content/plugins/ directory.
@@ -53,9 +149,6 @@ Privacy Policy rules of Line Messaging [https://terms.line.me/line_rules?lang=en
 ## Roadmap
 - Message pattern for selected status.
 - Multiple token id support for message broadcast.
-- Message broadcast to line group.
-- Add line sticker.
-- Attach event url.
 
 ## Contibute guidelines
 Thank you for your suggestion and support to the project. I very happy to help and give the thing I can do to the world. If you can help me to develop this plugin or join as a team members please follow below. I'll add your name to contributor members if you've joined.
@@ -66,6 +159,20 @@ Thank you for your suggestion and support to the project. I very happy to help a
 5. Create pull request with update details to developer.
 6. Waiting for approved.
 
+### Changelog
+#### version 1.1.0
+- Change admin ui
+- Change class name duplicate.
+- Multi language support.
+- API
+- Add postcode shortcode.
+- Direct method
+- Debug option.
+- Dynamic fields
+- Dashboard widget
+- Can use without Woocommerce
+---
+
 ### Welcome to the opensource world.
 
 ### [Wiki](https://git.iotech.co.th/iamapinan/woocommerce-line-notify/wikis), [Issue](https://git.iotech.co.th/iamapinan/woocommerce-line-notify/issues)

inc/Extras.php renamed to inc/Actions.php

@@ -3,12 +3,13 @@
  * Package: woo-line-notify
  * (c) Apinan Woratrakun (iOTech Enterprise Co.,Ltd.) <apinan@iotech.co.th>
  */
+// namespace WooLineNotify\Extras;
 if ( ! defined( 'ABSPATH' ) ) exit;
-class Extras {
+class Actions {
     /**
      * Change woocommerce state name to Thailand state.
      */
-    public static function thai_states( $states ) {
+    public function thai_states( $states ) {
         $states_set = array(
             'TH-81' => 'กระบี่',
             'TH-10' => 'กรุงเทพมหานคร',
@@ -90,4 +91,50 @@ public static function thai_states( $states ) {
         );
         return $states_set[$states];
     }
+
+    /**
+     * Send notify action.
+     */
+    public function send_notify($msg, $source = 'local') {
+        // Get plugin options
+        $get_option = get_option( '_option_notify' );
+        $get_debug = get_option( '_option_debug' );
+        $counter = get_option('wln_source_' . $source);
+        $endpoint = get_option('wln-api-endpoint');
+        // Header setup
+        $headers = array( 
+                'Authorization' => 'Bearer '. $get_option['token'],
+            );
+        // Request prepare
+        $args = array(
+            'method' => 'POST',
+            'timeout' => 45,
+            'httpversion' => '1.0',
+            'headers' => $headers,
+            'body' => array( 
+                'message' => $msg
+            ),
+        );
+        
+        // Post to line notify server.
+        $response = wp_remote_post( $endpoint, $args );
+        $status = wp_remote_retrieve_response_code($response);
+
+        update_option('wln_source_' . $source, $counter+1);
+        
+        if( isset( $get_debug['debug'] ) ) {
+            // Loging output
+            $log = "Status: ". wp_remote_retrieve_response_code($response) ."\nMessage: " . $msg . "\n" . "Response: " . str_replace('\\', '', json_encode($response));
+            $this->wln_debug_log( $log );
+        }
+
+        return $response;
+    }
+
+    public function wln_debug_log( $logs ) {
+        if( is_writable( WOO_LINE_NOTIFY_PATH .'logs/debug.log' ) ) {
+            file_put_contents( WOO_LINE_NOTIFY_PATH .'logs/debug.log', $logs . "\n\nDatetime: " . date('d/m/Y H:i') );
+        }
+    } 
+    
 }