, caches the status for a few seconds, and shows a real‑time door open/closed indicator (🟢/🔴) via [door_status] shortcode and the Admin Bar. * Version: 1.1.0 * Author: Joao Figueiredo (ChatGPT helper) * Author URI: https://jfig.net * License: GPL v2 or later * License URI: https://www.gnu.org/licenses/gpl-2.0.html * Text Domain: door-status-indicator */ if ( ! defined( 'ABSPATH' ) ) { exit; // Exit if accessed directly. } /* |-------------------------------------------------------------------------- | Configuration |-------------------------------------------------------------------------- | Place environment‑specific constants inside door-status-config.php. | They will be loaded automatically. If the file is missing we fall back to | bundled defaults so the plugin keeps working out‑of‑the‑box. */ $config_file = plugin_dir_path( __FILE__ ) . 'door-status-config.php'; if ( file_exists( $config_file ) ) { require_once $config_file; } else { // Fallback defaults – safe to adjust directly here if you prefer. define( 'DSI_API_URL', 'https://nodered.jfig.net/api/v1/door-open' ); define( 'DSI_CACHE_KEY', 'dsi_door_open_status' ); define( 'DSI_CACHE_TTL', 10 ); } /* |-------------------------------------------------------------------------- | Core – fetch & cache |-------------------------------------------------------------------------- */ /** * Retrieves the door‑open status (boolean) with transient caching. * * @return bool True if open, false if closed. */ function dsi_get_status() : bool { $cached = get_transient( DSI_CACHE_KEY ); if ( false !== $cached ) { return (bool) $cached; } $response = wp_remote_get( DSI_API_URL, [ 'timeout' => 3, 'user-agent' => 'DoorStatusIndicator/1.1 (+https://wordpress.org/)', ] ); if ( is_wp_error( $response ) ) { // On error, assume closed and set a short transient to avoid hammering. set_transient( DSI_CACHE_KEY, false, DSI_CACHE_TTL ); return false; } $body = wp_remote_retrieve_body( $response ); $decoded = json_decode( $body, true ); $status = false; if ( is_bool( $decoded ) ) { $status = $decoded; } elseif ( is_array( $decoded ) && isset( $decoded['open'] ) ) { $status = (bool) $decoded['open']; } set_transient( DSI_CACHE_KEY, $status, DSI_CACHE_TTL ); return $status; } /* |-------------------------------------------------------------------------- | Shortcode [door_status] |-------------------------------------------------------------------------- */ /** * Outputs a 🟢 or 🔴 indicator reflecting current door status. * Usage: [door_status] * * @return string HTML span with coloured emoji. */ function dsi_shortcode() : string { $open = dsi_get_status(); $emoji = $open ? '🟢' : '🔴'; return sprintf( '%s', $open ? 'open' : 'closed', $emoji ); } add_shortcode( 'door_status', 'dsi_shortcode' ); /* |-------------------------------------------------------------------------- | Admin Bar indicator |-------------------------------------------------------------------------- */ /** * Adds a live indicator to the WordPress Admin Bar (front‑ and back‑end). * * @param WP_Admin_Bar $wp_admin_bar The admin bar instance. */ function dsi_admin_bar( WP_Admin_Bar $wp_admin_bar ) : void { if ( ! current_user_can( 'read' ) ) { return; // Only show to logged‑in users who can read. } $open = dsi_get_status(); $emoji = $open ? '🟢' : '🔴'; $text = $open ? __( 'Door Open', 'door-status-indicator' ) : __( 'Door Closed', 'door-status-indicator' ); $wp_admin_bar->add_node( [ 'id' => 'door-status-indicator', 'title' => sprintf( '%s %s', $emoji, $text ), 'href' => '#', 'meta' => [ 'title' => $text, ], ] ); } add_action( 'admin_bar_menu', 'dsi_admin_bar', 1000 ); /* |-------------------------------------------------------------------------- | Front‑end inline CSS |-------------------------------------------------------------------------- */ function dsi_enqueue_assets() : void { if ( is_admin() ) { return; } $css = '.door-status-indicator{font-size:1.2em;line-height:1}'; wp_add_inline_style( 'wp-block-library', $css ); } add_action( 'wp_enqueue_scripts', 'dsi_enqueue_assets' ); /* |-------------------------------------------------------------------------- | WP‑CLI command (optional) |-------------------------------------------------------------------------- */ if ( defined( 'WP_CLI' ) && WP_CLI ) { WP_CLI::add_command( 'door-status', function() { $status = dsi_get_status() ? 'open 🟢' : 'closed 🔴'; WP_CLI::success( "Door is $status" ); } ); } // End of file