1.0.0

CHANGELOG.md

@@ -1,3 +1,7 @@
+### 1.0.0 ###
+
+* First submission to wordpress.org repo
+
 ### 0.0.2 ###
 
 * New: Add editable message

hooks.php

@@ -31,19 +31,13 @@ function __construct() {
 	 * admin hooks
 	*/
 	public function admin( 
-		\q\stand_with_ukraine\admin\api $api,
-		\q\stand_with_ukraine\admin\create $create,
 		\q\stand_with_ukraine\admin\read $read,
 		\q\stand_with_ukraine\admin\update $update,
-		\q\stand_with_ukraine\admin\delete $delete,
 		\q\stand_with_ukraine\admin\option $option 
 	):void {
 
-		$api->hooks();
-		$create->hooks();
 		$read->hooks();
 		$update->hooks();
-		$delete->hooks();
 
 		if( \is_admin() ){
 

library/admin/api.php

@@ -16,38 +16,20 @@
 */
 class api {
 
-    /**
-     * Class constructor to define object props
-     * 
-     * @since   0.0.1
-     * @return  void
-    */
-    function __construct() {
-
-	}
-
-	/**
-	 * WP Hooks
-	 * 
-	 * @since  	0.0.1
-	 * @return	__void
-	*/
-	public function hooks(){
-
-		// \add_action( 'wp_head', [ $this, 'javascript' ] );
-
-	}
-
 	/**
+	 * Get download URL from API source
 	 * 
-	 * @since 0.0.1
+	 * @return 	mixed
+	 * @since	0.0.1
 	*/
-	public function get_source_links(){}
+	public static function get_download_link():?string{}
 
 	/**
+	 * Get list of download links from API source
 	 * 
-	 * @since 0.0.1
+	 * @return	mixed
+	 * @since 	0.0.1
 	*/
-	public function get_donation_links(){}
+	public static function get_donation_links():?array{}
 
 }

library/admin/option.php

@@ -100,7 +100,7 @@ public function render_screen(){
 							</td>
 						</tr>
 
-						<tr class="qswu_message_tr hidden">
+						<tr class="qswu_message_tr">
 							<th scope="row"><label for="qswu_message"><?php \_e("Message Text:", "q-stand-with-ukraine"); ?></label></th>
 							<td>
 								<input name="qswu_message" type="text" id="qswu_message" value="<?php echo \esc_html( $_array['message'] ); ?>" class="regular-text" maxlength="100" />
@@ -193,6 +193,21 @@ public function render_screen(){
 							</td>
 						</tr>
 
+						<tr>
+							<th scope="row"><?php \_e("Custom CSS", "q-stand-with-ukraine"); ?></th>
+							<td>
+								<fieldset>
+									<legend class="screen-reader-text">
+										<span><?php \_e("Custom CSS", "q-stand-with-ukraine"); ?></span>
+									</legend>
+									<p>
+										<textarea name="qswu_css" rows="4" cols="50" id="qswu_css" class="large-text code"><?php echo \wp_kses_post( $_array['css'] ); ?></textarea>
+									</p>
+									<p class="date-time-doc">Add Custom CSS rules</p>
+								</fieldset>
+							</td>
+						</tr>
+
 					</tbody>
 				</table>
 
@@ -240,7 +255,7 @@ private static function confirm():void{
 		if ( isset($_GET['qswu_status']) && $_GET['qswu_status']=='success') {
 
 	?>
-   	<div id="message" class="updated notice is-dismissible">
+   	<div id="message" class="updated notice notice-success is-dismissible">
 		<p><?php \_e("Settings updated", "q-stand-with-ukraine"); ?></p>
       	<button type="button" class="notice-dismiss">
 			<span class="screen-reader-text"><?php \_e("Dismiss this notice.", "q-stand-with-ukraine"); ?></span>

library/admin/update.php

@@ -56,7 +56,7 @@ public function option(){
 		$_array['show_donate'] = isset( $_POST["qswu_show_donate"] ) ? (int) $_POST["qswu_show_donate"] : $_option['show_donate'];
 		$_array['show_download'] = isset( $_POST["qswu_show_download"] ) ? (int) $_POST["qswu_show_download"] : $_option['show_download'];
 		$_array['message'] = isset( $_POST["qswu_message"] ) ? \sanitize_text_field( $_POST["qswu_message"] ) : $_option['message'];
-		$_array['css'] = isset( $_POST["qswu_css"] ) ? \sanitize_text_field( $_POST["qswu_css"] ) : $_option['css'];
+		$_array['css'] = isset( $_POST["qswu_css"] ) ? \wp_kses_post( $_POST["qswu_css"] ) : $_option['css'];
 
 		// get all known donation urls ##
 		foreach( \q\stand_with_ukraine\admin\read::get_url_donate() as $_label => $_url ){

library/theme/render.php

@@ -49,22 +49,23 @@ public function hooks(){
 	*/
 	public function banner(){
 
-		// get stored values - returns defaults, if not edited ##
+		// get stored values - returns defaults, if not viewable ##
 		$_values = \q\stand_with_ukraine\admin\read::option();
 
-		// @todo - check if we can load all require ui options ##
-		if( ! $this->validate( $_values ) ){ return false; }
+		// check if banner is visible ##
+		if( ! $this->is_visible( $_values ) ){ return false; }
 
 		// get template markup ##
 		$_template = \q\stand_with_ukraine\theme\template::get();
 
-		// check visibillity settings ##
-		$_values['show_donate'] = $_values['show_donate'] === 1 ? 'visible' : 'hidden';
-		$_values['show_download'] = $_values['show_download'] === 1 ? 'visible' : 'hidden';
+		// define button visibillity settings ##
+		$_values['show_donate'] = isset( $_values['show_donate'] ) && $_values['show_donate'] === 1 ? 'visible' : 'hidden';
+		$_values['show_download'] = isset( $_values['show_download'] ) && $_values['show_download'] === 1 ? 'visible' : 'hidden';
 
 		// markup - array values are escaped ##
-		// @todo - use wp_kses ##
-		echo \q\stand_with_ukraine\theme\template::markup( $_template, $_values );
+		echo \wp_kses_post( 
+			\q\stand_with_ukraine\theme\template::markup( $_template, $_values ),
+		);
 
 	}
 
@@ -74,9 +75,9 @@ public function banner(){
 	 * @param	array
 	 * @since 	0.0.1
 	*/
-	public function validate( $array ):bool{
+	public function is_visible( $array ):bool{
 
-		return $array['show_banner'] === 1 ? true : false ;
+		return isset( $array['show_banner'] ) && $array['show_banner'] === 1 ? true : false ;
 
 	}
 

library/theme/template.php

@@ -77,7 +77,7 @@ public static function curvy_wrap( array $array = [], string $before = '{', stri
 
 		}
 
-		\__log( $_curvy_array );
+		// \__log( $_curvy_array );
 
 		return $_curvy_array;
 

plugin.php

@@ -28,7 +28,7 @@ final class plugin {
 	private static 
 
 		// current tag ##
-		$version = '0.0.2',
+		$version = '1.0.0',
 
 		// log ##
 		$log = null,

readme.md

@@ -3,7 +3,7 @@
 **Tags:** Banner, Plugin, Support, Ukraine  
 **Requires at least:** 5.0  
 **Tested up to:** 5.9.1  
-**Stable tag:** 0.0.2     
+**Stable tag:** 1.0.0     
 **License:** GPL-2.0+  
 
 Stand with Ukraine Banner Plugin for WordPress.org

readme.txt

@@ -0,0 +1,36 @@
+=== Export User Data ===
+Contributors: qlstudio
+Tags: anner, Plugin, Support, Ukraine  
+Requires PHP: 7.0  
+Requires at least: 4.8  
+Tested up to: 5.9.1  
+Stable tag: 1.0.0  
+License: GPLv2  
+
+Stand with Ukraine Banner Plugin for WordPress.org
+
+=== Description ===
+
+Version 0.0.2 is a very basic POC, which needs fleshing out into something more dynamic, attractive and flexible.
+
+Future plans:
+
+- Translation .po/.mo files
+- Admin screen option to control
+	- Select banner designs ( for example horizontal / corner triangle )
+- Template editor
+- Block option to include banner
+- Central list of donation sources, managed from API call
+
+== Screenshots ==
+
+1. Example of Admin Export View 
+2. Example of front-end view 
+
+== Changelog ==
+
+= 1.0.0 =
+First submission to wordpress.org
+
+= 0.0.2 =
+First release.

stand-with-ukraine.php

@@ -14,7 +14,7 @@
  * Plugin Name:     Stand with Ukraine Banner Plugin
  * Plugin URI:      https://github.com/qstudio/wordpress-plugin-stand-with-ukraine
  * Description:     Stand with Ukraine Banner Plugin for WordPress.org
- * Version:         0.0.2
+ * Version:         1.0.0
  * Author:          Q Studio
  * Author URI:      https://qstudio.us
  * License:         GPL-2.0+
@@ -52,7 +52,7 @@
 // validate instance ##
 if( ! ( $plugin instanceof \q\stand_with_ukraine\plugin ) ) {
 
-	error_log( 'Error in stand_with_ukraine plugin instance' );
+	error_log( 'Error in q\stand_with_ukraine plugin instance' );
 
 	// nothing else to do here ##
 	return;
@@ -69,11 +69,8 @@
 
 	// admin hooks ##
 	$hooks->admin( 
-		new \q\stand_with_ukraine\admin\api,
-		new \q\stand_with_ukraine\admin\create,
 		new \q\stand_with_ukraine\admin\read,
 		new \q\stand_with_ukraine\admin\update,
-		new \q\stand_with_ukraine\admin\delete,
 		new \q\stand_with_ukraine\admin\option,
 	);