Skip to content

Commit 1de2c0d

Browse files
committed
docs: add CHANGELOG entry and update plugin settings docs for HSplitView layout
1 parent 0594f9f commit 1de2c0d

4 files changed

Lines changed: 34 additions & 9 deletions

File tree

CHANGELOG.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
99

1010
### Changed
1111

12+
- Redesigned Plugins settings tab with HSplitView master-detail layout: plugin list on the left, detail pane on the right, matching macOS conventions
1213
- Replaced ~40 hardcoded `DatabaseType` switches across ~20 UI files with dynamic plugin property lookups via `PluginManager`, so third-party plugins get correct UI behavior (colors, labels, editor language, feature toggles) automatically
1314
- ConnectionFormView now fully dynamic: pgpass toggle, password visibility, and SSH/SSL tab visibility all driven by plugin metadata (`FieldSection`, `hidesPassword`, `supportsSSH`/`supportsSSL`) instead of hardcoded type checks
1415
- Replaced `AppState.isMongoDB`/`isRedis` booleans with `AppState.editorLanguage: EditorLanguage` for extensible editor language detection

docs/customization/settings.mdx

Lines changed: 11 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -372,6 +372,8 @@ Manage database driver plugins from the **Plugins** tab in Settings.
372372

373373
### Installed Plugins
374374

375+
The Installed tab uses a split-view layout: the plugin list on the left, and the detail pane on the right.
376+
375377
TablePro ships with 8 built-in database driver plugins:
376378

377379
| Plugin | Database Types | Default Port |
@@ -389,21 +391,27 @@ Each plugin has a toggle to enable or disable it. Disabled plugins hide their da
389391

390392
### Plugin Details
391393

392-
Click a plugin to view its details: version, bundle ID, supported capabilities, database type, and default port. Driver plugins can provide custom settings panels that appear in this detail view.
394+
Select a plugin in the list to view its details in the right pane: version, bundle ID, supported capabilities, database type, and default port. Driver plugins can provide custom settings panels that appear in this detail view.
395+
396+
### Browse Plugins
397+
398+
The Browse tab also uses a split-view layout. Search and filter plugins by category using the controls at the top. Select a plugin in the list to view its full details and install it from the right pane.
393399

394400
### Installing Third-Party Plugins
395401

396-
1. Click **Install from File...**
402+
1. Click the **+** button below the plugin list
397403
2. Select a `.zip` archive containing a `.tableplugin` bundle
398404
3. TablePro verifies the code signature and installs the plugin
399405

406+
You can also drag and drop a `.tableplugin` or `.zip` file onto the Plugins settings view to install it.
407+
400408
<Warning>
401409
Only install plugins from sources you trust. TablePro checks the code signature of sideloaded plugins but cannot guarantee their behavior.
402410
</Warning>
403411

404412
### Uninstalling Plugins
405413

406-
User-installed plugins show an **Uninstall** button in the plugin details view. Built-in plugins cannot be uninstalled, only disabled.
414+
Select a user-installed plugin and click the **-** button below the list, or use the **Uninstall** button in the detail pane. Built-in plugins cannot be uninstalled, only disabled.
407415

408416
### Advanced Settings
409417

docs/vi/customization/settings.mdx

Lines changed: 11 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -370,6 +370,8 @@ Quản lý plugin driver database từ tab **Plugins** trong Settings.
370370

371371
### Plugin Đã cài
372372

373+
Tab Installed sử dụng bố cục chia đôi: danh sách plugin bên trái và chi tiết bên phải.
374+
373375
TablePro đi kèm 8 plugin driver database tích hợp sẵn:
374376

375377
| Plugin | Loại Database | Cổng Mặc định |
@@ -387,21 +389,27 @@ Mỗi plugin có nút bật/tắt. Plugin bị tắt sẽ ẩn loại database k
387389

388390
### Chi tiết Plugin
389391

390-
Click vào plugin để xem chi tiết: phiên bản, bundle ID, khả năng hỗ trợ, loại database và cổng mặc định. Driver plugin có thể cung cấp panel cài đặt tùy chỉnh riêng, hiển thị trong phần chi tiết plugin.
392+
Chọn plugin trong danh sách để xem chi tiết ở khung bên phải: phiên bản, bundle ID, khả năng hỗ trợ, loại database và cổng mặc định. Driver plugin có thể cung cấp panel cài đặt tùy chỉnh riêng, hiển thị trong phần chi tiết plugin.
393+
394+
### Duyệt Plugin
395+
396+
Tab Browse cũng sử dụng bố cục chia đôi. Tìm kiếm và lọc plugin theo danh mục bằng các điều khiển ở phía trên. Chọn plugin trong danh sách để xem chi tiết đầy đủ và cài đặt từ khung bên phải.
391397

392398
### Cài đặt Plugin Bên thứ ba
393399

394-
1. Nhấp **Install from File...**
400+
1. Nhấp nút **+** bên dưới danh sách plugin
395401
2. Chọn file `.zip` chứa bundle `.tableplugin`
396402
3. TablePro xác minh chữ ký mã và cài đặt plugin
397403

404+
Bạn cũng có thể kéo thả file `.tableplugin` hoặc `.zip` vào cửa sổ cài đặt Plugins để cài đặt.
405+
398406
<Warning>
399407
Chỉ cài plugin từ nguồn đáng tin cậy. TablePro kiểm tra chữ ký mã của plugin sideload nhưng không đảm bảo hành vi của chúng.
400408
</Warning>
401409

402410
### Gỡ cài đặt Plugin
403411

404-
Plugin do người dùng cài hiện nút **Uninstall** trong chi tiết plugin. Plugin tích hợp sẵn không thể gỡ, chỉ có thể tắt.
412+
Chọn plugin do người dùng cài và nhấp nút **-** bên dưới danh sách, hoặc dùng nút **Uninstall** trong khung chi tiết. Plugin tích hợp sẵn không thể gỡ, chỉ có thể tắt.
405413

406414
### Cài Đặt Nâng Cao
407415

docs/zh/customization/settings.mdx

Lines changed: 11 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -359,6 +359,8 @@ TablePro 使用 [Sparkle](https://sparkle-project.org/) 进行更新。当有可
359359

360360
### 已安装插件
361361

362+
"已安装"标签页使用分栏布局:左侧为插件列表,右侧为详情面板。
363+
362364
TablePro 内置 8 个数据库驱动插件:
363365

364366
| 插件 | 数据库类型 | 默认端口 |
@@ -376,21 +378,27 @@ TablePro 内置 8 个数据库驱动插件:
376378

377379
### 插件详情
378380

379-
点击插件查看详情:版本、Bundle ID、支持的功能、数据库类型和默认端口。驱动插件还可以提供自定义设置面板,用于配置特定于该驱动的选项。
381+
在列表中选择插件即可在右侧面板查看详情:版本、Bundle ID、支持的功能、数据库类型和默认端口。驱动插件还可以提供自定义设置面板,用于配置特定于该驱动的选项。
382+
383+
### 浏览插件
384+
385+
"浏览"标签页同样使用分栏布局。使用顶部的搜索和分类筛选控件查找插件。在列表中选择插件即可查看完整详情并从右侧面板安装。
380386

381387
### 安装第三方插件
382388

383-
1. 点击 **Install from File...**
389+
1. 点击插件列表下方的 **+** 按钮
384390
2. 选择包含 `.tableplugin` 包的 `.zip` 压缩文件
385391
3. TablePro 验证代码签名并安装插件
386392

393+
也可以将 `.tableplugin``.zip` 文件拖放到插件设置窗口进行安装。
394+
387395
<Warning>
388396
只安装来自你信任的来源的插件。TablePro 会检查侧载插件的代码签名,但无法保证其行为。
389397
</Warning>
390398

391399
### 卸载插件
392400

393-
用户安装的插件在插件详情视图中显示 **Uninstall** 按钮。内置插件不能卸载,只能禁用。
401+
选择用户安装的插件后点击列表下方的 **-** 按钮,或使用详情面板中的 **Uninstall** 按钮。内置插件不能卸载,只能禁用。
394402

395403
### 高级设置
396404

0 commit comments

Comments
 (0)