<?php
/**
 * Plugin Name:       AgentTally State Agent Statistics
 * Plugin URI:        https://usrealtorlist.com/
 * Description:       Show how many real estate agents work in each US state, with a sortable table or a single-state figure. Data bundled with the plugin, no external calls.
 * Version:           1.0.3
 * Requires at least: 6.0
 * Requires PHP:      7.4
 * Author:            Base 7 Studio
 * License:           GPL-2.0-or-later
 * License URI:       https://www.gnu.org/licenses/gpl-2.0.html
 * Text Domain:       agenttally-state-agent-statistics
 *
 * Deliberately NOT another agent directory -- that is a different plugin doing a
 * different job. This one publishes a dataset: how many agents each state has,
 * how many are reachable by phone, how many hold a producer award. Real estate
 * bloggers, brokerages and market-report pages cite numbers like these, and
 * nobody else publishes them per state.
 *
 * NO EXTERNAL REQUESTS. The figures ship in includes/data.json, dated, and are
 * replaced with each plugin update. A plugin that called an API on every render
 * would need a privacy disclosure, would slow the host site, and would break
 * whenever our server did.
 */

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

define( 'USRS_VERSION', '1.0.3' );
define( 'USRS_PATH', plugin_dir_path( __FILE__ ) );
define( 'USRS_URL', plugin_dir_url( __FILE__ ) );

require_once USRS_PATH . 'includes/data.php';
require_once USRS_PATH . 'includes/render.php';
require_once USRS_PATH . 'includes/admin.php';

/**
 * [agenttally_state_agent_stats] — the whole table.
 *   [agenttally_state_agent_stats columns="agents,phone,award" sort="agents" limit="10"]
 * [agenttally_state_agent_stats state="FL"] — one state, inline.
 * The source credit line is opt-in: credit="yes".
 */
function usrs_shortcode( $atts ) {
	$a = shortcode_atts(
		array(
			'state'   => '',
			'sort'    => 'agents',
			'limit'   => 0,
			'columns' => 'agents,phone,award',
			'credit'  => 'no',
		),
		$atts,
		'agenttally_state_agent_stats'
	);

	wp_enqueue_style( 'agenttally-state-agent-statistics' );

	if ( '' !== $a['state'] ) {
		return usrs_render_single( $a['state'] );
	}
	return usrs_render_table( $a );
}
add_shortcode( 'agenttally_state_agent_stats', 'usrs_shortcode' );

/**
 * Styles are registered always but only ENQUEUED where the table is used, so a
 * site that never uses it ships no extra CSS. The editor script is plain
 * JavaScript on the wp.* globals (no build step) and only loads in the editor.
 */
function usrs_register_assets() {
	wp_register_style(
		'agenttally-state-agent-statistics',
		USRS_URL . 'assets/style.css',
		array(),
		USRS_VERSION
	);
	wp_register_script(
		'agenttally-state-agent-statistics-block',
		USRS_URL . 'assets/block.js',
		array( 'wp-blocks', 'wp-element', 'wp-block-editor', 'wp-components', 'wp-server-side-render', 'wp-i18n' ),
		USRS_VERSION,
		true
	);
	// The state list and the dataset date for the block's sidebar, from the bundled data.
	$states = array();
	foreach ( usrs_data()['states'] as $s ) {
		$states[] = array(
			'code' => $s['code'],
			'name' => $s['name'],
		);
	}
	usort(
		$states,
		function ( $x, $y ) {
			return strcmp( $x['name'], $y['name'] );
		}
	);
	wp_add_inline_script(
		'agenttally-state-agent-statistics-block',
		'window.agenttallyBlockData = ' . wp_json_encode(
			array(
				'states' => $states,
				'asOf'   => usrs_as_of(),
			)
		) . ';',
		'before'
	);
	wp_set_script_translations( 'agenttally-state-agent-statistics-block', 'agenttally-state-agent-statistics' );
}
add_action( 'init', 'usrs_register_assets' );

/**
 * Gutenberg block. The editor shows a live, server-rendered preview and a
 * sidebar with every option, so nobody needs to know the shortcode; the
 * front end is rendered by the same code as the shortcode.
 */
function usrs_register_block() {
	if ( ! function_exists( 'register_block_type' ) ) {
		return;
	}
	register_block_type(
		'agenttally-state-agent-statistics/table',
		array(
			'api_version'     => 2,
			'title'           => __( 'AgentTally State Agent Statistics', 'agenttally-state-agent-statistics' ),
			'category'        => 'widgets',
			'icon'            => 'chart-bar',
			'description'     => __( 'Agent counts by US state: a table, or one state inline.', 'agenttally-state-agent-statistics' ),
			'keywords'        => array( 'real estate', 'agents', 'statistics' ),
			'editor_script'   => 'agenttally-state-agent-statistics-block',
			'style'           => 'agenttally-state-agent-statistics',
			'attributes'      => array(
				'state'   => array(
					'type'    => 'string',
					'default' => '',
				),
				'sort'    => array(
					'type'    => 'string',
					'default' => 'agents',
				),
				'limit'   => array(
					'type'    => 'number',
					'default' => 0,
				),
				'columns' => array(
					'type'    => 'string',
					'default' => 'agents,phone,award',
				),
				'credit'  => array(
					'type'    => 'boolean',
					'default' => false,
				),
			),
			'render_callback' => function ( $attrs ) {
				return usrs_shortcode(
					array(
						'state'   => isset( $attrs['state'] ) ? $attrs['state'] : '',
						'sort'    => isset( $attrs['sort'] ) ? $attrs['sort'] : 'agents',
						'limit'   => isset( $attrs['limit'] ) ? $attrs['limit'] : 0,
						'columns' => isset( $attrs['columns'] ) ? $attrs['columns'] : 'agents,phone,award',
						'credit'  => ! empty( $attrs['credit'] ) ? 'yes' : 'no',
					)
				);
			},
		)
	);
}
add_action( 'init', 'usrs_register_block' );