ImageDropdown PHPRunner custom Edit control
==========================================

Purpose
-------
ImageDropdown replaces a regular dropdown with a compact image + text dropdown.
It stores a single value in the underlying field, exactly like a normal lookup dropdown.

Files
-----
EditImageDropdown.php
EditImageDropdown.js
imagedropdown.css
sample.php
optional placeholder image, for example images/soccer_ball.png

Basic team settings
-------------------
$this->settings["lookup_table"] = "wc_teams";
$this->settings["key_field"] = "id";
$this->settings["label_field"] = "team_name";
$this->settings["image_field"] = "flag_url";
$this->settings["order_by"] = "team_name";

Podium fields
-------------
For champion_team_id, second_place_team_id, and third_place_team_id, use the same group name
and enable duplicate prevention:

$this->settings["picker_group"] = "podium";
$this->settings["prevent_duplicates"] = 1;

Top scorer example
------------------
Use lookup_sql to join wc_top_scorers to wc_teams and show team flags:

$this->settings["lookup_sql"] = "SELECT s.id AS ip_key, CONCAT(s.player_name, ' (', t.team_name, ')') AS ip_label, t.flag_url AS ip_image FROM wc_top_scorers s INNER JOIN wc_teams t ON t.id = s.team_id ORDER BY s.player_name";

Notes
-----
- EditImageDropdown.js is loaded automatically by PHPRunner for this custom edit control.
- imagedropdown.css is loaded explicitly from the plugin root folder.
- lookup_sql is trusted plugin configuration, not user input.


Version 2 changes:
- Dropdown opens above the control when there is not enough space below.
- placeholder_image is no longer enforced; leave it empty to show text only.
