UK

Плагіни IDE

JumPHP IDE розширюється плагінами на PHP. Плагін може додати:

  • дії (меню, Find Action, гарячі клавіші);
  • вікна інструментів;
  • конфігурації запуску;
  • автодоповнення та проблеми (підкреслюються під час введення);
  • інструменти для Claude.

Плагіни працюють у настільній версії IDE.

Встановити плагін

В IDE відкрийте Tools › Plugins…. Там є:

  • На jumphp.net: знайдіть плагін і натисніть Install. Коли виходить новіша версія, кнопка змінюється на Update.
  • Install from a Folder…: встановлює теку плагіна.
  • Список встановлених плагінів: їх можна вмикати, вимикати й видаляти.

Оновлення: IDE перевіряє jumphp.net невдовзі після запуску, а потім кожні 6 годин. Сповіщення пропонує Update; з Update plugins automatically IDE встановлює їх сама. Нова версія працює після наступного запуску.

Плагін — це PHP, що працює з вашими правами: встановлюйте лише ті, яким довіряєте.

Створити плагін

bin/jumphp plugin:new todo-finder "TODO Finder"
bin/jumphp install todo-finder
bin/jumphp test todo-finder

Також можна вибрати New Project › IDE plugin в IDE.

Клас плагіна, src/TodoPlugin.php, додає те, що він приносить:

public function activate(Api $ide): void
{
    $ide->action('count', 'Count the TODOs', fn (EditorState $at) => substr_count($at->text, 'TODO') . ' TODO', ['kbd' => 'Ctrl+Alt+T']);
    $ide->toolWindow('todos', 'TODOs', fn () => Ui::column(
        Ui::list(array_map(fn ($t) => Ui::item($t['text'], fn () => $ide->openFile($t['path'], $t['line'])), $this->todos())),
    ));
    $ide->diagnostics('*.php', fn (string $path, string $text) => $this->fixmes($text));
}
  • Вікна інструментів будуються на PHP з простих елементів: тексти, кнопки, списки, поля, прапорці. IDE малює їх у своєму стилі.
  • Клацання та інші дії користувача викликають ваш PHP.
  • Тести (PluginTestCase) працюють із плагіном без вікна. Вони запускають дію, читають вікно, клацають у ньому, запитують автодоповнення.

Щоб спробувати: Tools › Plugins…, потім Install in the IDE поруч із плагіном проєкту.

Інструменти для Claude

IDE дає своєму Claude MCP-сервер jumphp-ide. Через нього Claude керує IDE: відкриває файли, запускає тести, налагоджує. Плагін додає туди власні інструменти:

$ide->mcpTool('list_todos', 'The TODO comments of the project: path, line, text.',
    fn (array $args) => $this->todos($args['path'] ?? ''),
    ['path' => ['type' => 'string', 'description' => 'only under this folder']]);

Claude бачить інструмент як mcp__jumphp-ide__plugin_todo_finder_list_todos. Він обирає його за описом: вкажіть, що він повертає і коли його використовувати. Інструмент працює на PHP всередині IDE й ніколи не повинен блокувати.

Опублікувати на jumphp.net

У Tools › Plugins… натисніть Publish on jumphp.net поруч із плагіном проєкту. Потрібно увійти в обліковий запис. Після цього плагін з'явиться на сторінці плагінів.

  • Перший обліковий запис, що опублікував ідентифікатор, стає його власником.
  • Кожна версія лишається доступною. Щоб опублікувати нову, збільште version у composer.json.
  • bin/jumphp plugin:pack todo-finder створює такий самий .zip.
  • Будь-хто може поставити плагіну від 1 до 5 зірок — на його сторінці чи в IDE (Rate…). Публічна статистика: завантаження й оцінка. Автор також бачить особисту статистику (перегляди, встановлення, оновлення, версії, оцінки) на сторінці, увійшовши, і в IDE (Statistics).