{"id":30030444,"url":"https://github.com/rynokins/acf-json-tree-view","last_synced_at":"2026-04-30T08:37:31.400Z","repository":{"id":307742725,"uuid":"1029119832","full_name":"rynokins/acf-json-tree-view","owner":"rynokins","description":"A VS Code extension that provides an enhanced tree view for managing Advanced Custom Fields (ACF) JSON Field Groups in WordPress projects.","archived":false,"fork":false,"pushed_at":"2025-08-01T22:06:41.000Z","size":515,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-14T19:37:32.269Z","etag":null,"topics":["acf","json","vscode-extension","wordpress"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rynokins.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-30T14:51:44.000Z","updated_at":"2025-08-01T22:04:16.000Z","dependencies_parsed_at":"2025-08-02T00:25:21.302Z","dependency_job_id":"a8bed0d1-c99d-484c-9db9-f23393b6c387","html_url":"https://github.com/rynokins/acf-json-tree-view","commit_stats":null,"previous_names":["rynokins/acf-json-tree-view"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/rynokins/acf-json-tree-view","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rynokins%2Facf-json-tree-view","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rynokins%2Facf-json-tree-view/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rynokins%2Facf-json-tree-view/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rynokins%2Facf-json-tree-view/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rynokins","download_url":"https://codeload.github.com/rynokins/acf-json-tree-view/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rynokins%2Facf-json-tree-view/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32459420,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T22:27:22.272Z","status":"online","status_checked_at":"2026-04-30T02:00:05.929Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["acf","json","vscode-extension","wordpress"],"created_at":"2025-08-06T19:01:39.795Z","updated_at":"2026-04-30T08:37:31.395Z","avatar_url":"https://github.com/rynokins.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ACF JSON Tree View\n\n[![Visual Studio Marketplace Version](https://img.shields.io/visual-studio-marketplace/v/rynokins.acf-json-tree-view?style=flat-square)](https://marketplace.visualstudio.com/items?itemName=rynokins.acf-json-tree-view)\n[![Visual Studio Marketplace Installs](https://img.shields.io/visual-studio-marketplace/i/rynokins.acf-json-tree-view?style=flat-square)](https://marketplace.visualstudio.com/items?itemName=rynokins.acf-json-tree-view)\n\nA Visual Studio Code extension that provides an enhanced tree view for managing Advanced Custom Fields (ACF) JSON Field Groups in WordPress projects.\n\nView a list of the titles of your Field Groups instead of the randomized `group_abcdefg123456.json` filenames! Add colors and icons to distinguish between the types of ACF Field Groups using location rules or titles, or both! And more.\n\n![ACF JSON Tree View Screenshot](./screenshot.png)\n\n## Features\n- List view of the titles of your ACF Field Groups\n- Opening via ACF JSON Tree View will open your json file while avoiding setting the focus to the json file in the explorer view.\n- Enhanced tooltips in the tree view + adds title to tooltips in the explorer view\n\n### Theme-Based Organization\n- Automatically organizes ACF Field Groups by WordPress theme\n- Parses `style.css` to display theme names\n- Collapsible theme folders for better navigation\n- Shows child theme Field Group overrides with visual indicators (assuming you're loading both parent and child Field Groups, like below)\n```php\n/**\n * Override parent theme's acf-json\n * --\n * This code will prepend the parent theme's path for you\n * so you can load parent theme as well as child theme Field Groups.\n */\nadd_filter( 'acf/settings/load_json', function($paths) {\n  if (is_child_theme()) {\n    array_unshift($paths, get_template_directory() . '/acf-json');\n  }\n  return $paths;\n});\n```\n\n### Customizable Field Group Types\n- Define custom icons, colors, and labels based on field group properties\n- Support for complex matching rules with AND/OR conditions\n- Rule weighting system to prioritize specific matching criteria\n\n### JSON Key Management\nAdditional commands to make editing your ACF JSON files easier. Use commands to generate a new random 13 character keys for groups or fields.\n- *Generate new ACF Field key*\n  - Generates a new key in the currently focused field object\n- *Generate New Field Key (Replace All)*\n  - New key that replaces all matching instances with the new generated key\n- *Generate New Group Key (Update Filename)*\n  - Prompts you to save with the new group key\n- *Generate New Keys for All Fields*\n  - Bulk generate new for all keys, replaces all matching instances\n\n\n### Enhanced Context Menu\n- Standard file operations (copy path, rename, delete, etc.)\n- ACF-specific key management operations\n- Direct access to extension settings\n- \"Open and Reveal in Explorer\" functionality\n\n## Configuration\nCustomize via settings, either search for `acfJsonTreeView` or use the ⚙️ gear button in the tree view's title bar.\n\n### Icon Rules\nCustomize how Field Groups are categorized and displayed using icon rules. **Autocomplete is enabled for icons and colors with 300+ VS Code icons and 80+ theme colors available.**\n\nFor a visual reference of available icons, see the [VS Code Icon Reference](https://code.visualstudio.com/api/references/icons-in-labels#icon-listing).\n\n```json\n\"acfJsonTreeView.iconRules\": [\n  {\n    \"name\": \"Post Type Settings\",\n    \"weight\": 1,\n    \"condition\": {\n      \"and\": [\n        { \"locationParam\": \"post_type\" },\n        { \"titleContains\": \"settings\" }\n      ]\n    },\n    \"icon\": \"gear\",\n    \"color\": \"charts.blue\",\n    \"typeLabel\": \"Post Type Settings\"\n  },\n  {\n    \"name\": \"Post Type Fields\",\n    \"weight\": 0,\n    \"condition\": {\n      \"locationParam\": \"post_type\"\n    },\n    \"icon\": \"file-text\",\n    \"color\": \"charts.green\",\n    \"typeLabel\": \"Post Type Fields\"\n  }\n]\n```\n\n#### Condition Types\n- **Simple Conditions**:\n  ```json\n  { \"titleContains\": \"block\" }\n  { \"locationParam\": \"post_type\" }\n  ```\n\n- **AND Conditions** (all must match):\n  ```json\n  {\n    \"and\": [\n      { \"titleContains\": \"block\" },\n      { \"locationParam\": \"post_type\" }\n    ]\n  }\n  ```\n\n- **OR Conditions** (at least one must match):\n  ```json\n  {\n    \"or\": [\n      { \"titleContains\": \"block\" },\n      { \"titleContains\": \"section\" }\n    ]\n  }\n  ```\n\n- **Nested Conditions**:\n  ```json\n  {\n    \"and\": [\n      { \"titleContains\": \"settings\" },\n      {\n        \"or\": [\n          { \"locationParam\": \"options_page\" },\n          { \"locationParam\": \"block\" }\n        ]\n      }\n    ]\n  }\n  ```\n\n#### Rule Properties\n| Property | Type | Description |\n|----------|------|-------------|\n| `name` | string | Unique name for the rule |\n| `weight` | number | Priority (higher = evaluated first) |\n| `condition` | object | Matching criteria (see above) |\n| `icon` | string | VS Code theme icon name |\n| `color` | string | Theme color ID |\n| `typeLabel` | string | Display label for field group type |\n\n### Theme Settings\n| Setting | Default | Description |\n|---------|---------|-------------|\n| `acfJsonTreeView.ignoreThemes` | `[]` | List of theme names to exclude from tree view |\n| `acfJsonTreeView.themeIcon` | `\"folder\"` | Icon for theme folders |\n| `acfJsonTreeView.themeColor` | `\"folderIcons.folderForeground\"` | Color for theme folder icons |\n\n### Override Settings\n| Setting | Default | Description |\n|---------|---------|-------------|\n| `acfJsonTreeView.showOverrideIndicator` | `true` | Show indicator for field group overrides |\n| `acfJsonTreeView.overrideIcon` | `\"add\"` | Icon for override indicators |\n| `acfJsonTreeView.overrideColor` | `\"charts.orange\"` | Color for override indicators |\n\n## Usage\n\n### Accessing the Tree View\n1. Open the VS Code Explorer (default shortcut: `Ctrl+Shift+E` or `Cmd+Shift+E` on Mac)\n2. Look for \"ACF Field Groups\" in the explorer view\n\n### Context Menu Operations\nRight-click on any field group or theme to access:\n- Standard file operations (Open, Copy Path, Rename, Delete, etc.)\n- ACF Key Management operations\n- Settings access\n\n### Key Management\n1. Right-click on a field group JSON file\n2. Select \"ACF Key Management\" submenu\n3. Choose from:\n   - **Generate New Group Key** - Creates new group key and prompts to update filename\n   - **Generate New Field Key (Replace All)** - Creates new field key and updates all references\n   - **Generate New Keys for All Fields** - Updates all field keys in the file\n\n## Requirements\n\nNone. Works with the `acf-json` folder sugggested by the [ACF](https://github.com/elliotcondon/acf) extension.\n\n\n## Contributing\n\nContributions are welcome! Please feel free to submit issues or pull requests.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n---","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frynokins%2Facf-json-tree-view","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frynokins%2Facf-json-tree-view","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frynokins%2Facf-json-tree-view/lists"}