Merge pull request #14 from alex-storojenko/develop

1.14.1

Author: alex-storozhenko

contracts/interface-think-input-initiator.php

@@ -7,8 +7,21 @@
 	 * @package wp-think-framework
 	 */
 	interface Think_Input_Initiator {
-		function get_data( $input_id );
+        /**
+         * Get data from storage by input_id
+         *
+         * @param $input_id
+         *
+         * @return mixed
+         */
+	    function get_data( $input_id );
 
+        /**
+         * Unique key
+         * for processing input
+         *
+         * @return mixed
+         */
 		function get_key();
 	}
 }

contracts/interface-think-input.php

@@ -9,14 +9,39 @@
 	 * @package wp-think-framework
 	 */
 	interface Think_Input {
-		public function get_id();
+        /**
+         * Get unique id of input
+         *
+         * @return mixed
+         */
+	    public function get_id();
 
+        /**
+         * Get label of input
+         *
+         * @return mixed
+         */
 		public function get_label();
 
+        /**
+         * Get options for input
+         *
+         * @return mixed
+         */
 		public function get_options();
 
+        /**
+         * Get value of input
+         *
+         * @return mixed
+         */
 		public function get_value();
 
+        /**
+         * Render html
+         *
+         * @return string
+         */
 		public function render();
 	}
 }

contracts/interface-think-template.php

@@ -9,6 +9,11 @@
 	 * @package wp-think-framework
 	 */
 	interface Think_Template {
-		public static function render( array $data );
+        /**
+         * render html
+         *
+         * @param array $data
+         */
+	    public static function render( array $data );
 	}
 }

metabox/class-think-metaboxes.php

@@ -165,9 +165,9 @@ class Think_Metaboxes implements Think_Input_Initiator {
 		 * @param string $meta_key
 		 */
 		protected function __construct( $screen, $structure, $context, $priority, $meta_key ) {
-			$this->post_type = $screen;
+			$this->screen    = $screen;
 			$this->structure = $structure;
-			$this->place     = $context;
+			$this->context   = $context;
 			$this->priority  = $priority;
 			$this->meta_key  = $meta_key;
 			$this->nonce_key = $this->screen . $this->meta_key . uniqid( '_' );
@@ -182,6 +182,8 @@ protected function __construct( $screen, $structure, $context, $priority, $meta_
 		}
 
 		/**
+         * @inheritdoc
+         *
 		 * Get data from DB
 		 *
 		 * @param $input_id
@@ -196,6 +198,8 @@ public function get_data( $input_id, $single = true ) {
 		}
 
 		/**
+         * @inheritdoc
+         *
 		 * Get meta_key
 		 *
 		 * @return string
@@ -229,7 +233,7 @@ protected function add_metabox( $id, $title, $fields ) {
 						$input->render();
 					}
 				}
-			}, $this->post_type, $this->place, $this->priority );
+			}, $this->screen, $this->context, $this->priority );
 		}
 
 		/**

options/class-think-options.php

@@ -166,6 +166,8 @@ function () {
 		}
 
 		/**
+         * @inheritdoc
+         *
 		 * Return data from DB by input_id
 		 *
 		 * @param int|null $input_id
@@ -181,6 +183,8 @@ public function get_data( $input_id = null ) {
 		}
 
 		/**
+         * @inheritdoc
+         *
 		 * Get key ($this->options_key)
 		 *
 		 * @return mixed

options/templates/class-think-options-page-template.php

@@ -15,13 +15,15 @@ class Think_Options_Page_Template implements Think_Template {
 		 *
 		 * @throws Think_Exception_Bad_Args_For_Called_Func
 		 *
-		 * @return void
+		 * @return string
 		 */
 		public static function render( array $data ) {
 			if ( empty( $data['slug'] ) ) {
 				throw new Think_Exception_Bad_Args_For_Called_Func( 'Required argument "slug" don\'t exist or empty' );
 			}
 
+			ob_start();
+
 			$slug        = $data['slug'];
 			$options_key = $data['options_key'];
 			?>
@@ -78,6 +80,10 @@ public static function render( array $data ) {
                 </div>
             </div>
 			<?php
+
+            $content = ob_end_flush();
+
+            return $content;
 		}
 	}
 }

readme.txt

@@ -65,4 +65,9 @@ WordPress Think Framework gives you the ability to quickly and easily create inc
 = 1.14.0 =
 * Fix small bugs
 * Change Think_Customizer caller Think_Customizer::customize($structure)
-* Add possible multiple uses Think_Customizer::customize();
+* Add possible multiple uses Think_Customizer::customize();
+
+= 1.14.1 =
+* Add comments to contract
+* Fix small bugs in metabox factory
+* Add ob in option page template