{"id":15637662,"url":"https://github.com/ndiego/icon-block","last_synced_at":"2025-04-05T06:06:49.686Z","repository":{"id":44777857,"uuid":"408909304","full_name":"ndiego/icon-block","owner":"ndiego","description":"Effortlessly add SVG icons and graphics to your website.","archived":false,"fork":false,"pushed_at":"2024-11-08T19:18:58.000Z","size":9645,"stargazers_count":133,"open_issues_count":16,"forks_count":19,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-03-29T05:06:28.624Z","etag":null,"topics":["gutenberg","gutenberg-blocks","wordpress","wordpress-plugin"],"latest_commit_sha":null,"homepage":"https://nickdiego.com/projects/icon-block/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ndiego.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2021-09-21T17:16:05.000Z","updated_at":"2025-03-24T06:54:33.000Z","dependencies_parsed_at":"2024-01-02T21:41:39.200Z","dependency_job_id":"15102c75-a6e8-4bad-af72-c44e31ebdc8a","html_url":"https://github.com/ndiego/icon-block","commit_stats":{"total_commits":232,"total_committers":5,"mean_commits":46.4,"dds":0.4051724137931034,"last_synced_commit":"c64c32d15585b10b8326621586efb8a8ece2a1a8"},"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ndiego%2Ficon-block","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ndiego%2Ficon-block/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ndiego%2Ficon-block/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ndiego%2Ficon-block/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ndiego","download_url":"https://codeload.github.com/ndiego/icon-block/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247294536,"owners_count":20915340,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["gutenberg","gutenberg-blocks","wordpress","wordpress-plugin"],"created_at":"2024-10-03T11:12:26.692Z","updated_at":"2025-04-05T06:06:49.672Z","avatar_url":"https://github.com/ndiego.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Icon Block\n\n![The Icon Block](https://github.com/ndiego/icon-block/blob/main/_wordpress-org/banner-1544x500.png)\n\n[![Active Installs](https://img.shields.io/wordpress/plugin/installs/icon-block?logo=wordpress\u0026logoColor=%23fff\u0026label=Active%20Installs\u0026labelColor=%2323282D\u0026color=%2323282D)](https://wordpress.org/plugins/icon-block/) [![Playground Demo Link](https://img.shields.io/wordpress/plugin/v/icon-block?logo=wordpress\u0026logoColor=%23fff\u0026label=Playground%20Demo\u0026labelColor=%233858e9\u0026color=%233858e9)](https://playground.wordpress.net/?blueprint-url=https://raw.githubusercontent.com/ndiego/icon-block/main/_playground/blueprint.json)\n\nThe Icon Block plugin registers a single, easy-to-use block that allows you to add custom SVG icons and graphics to the WordPress block editor (Gutenberg). The plugin also includes the complete WordPress icon library with 290+ SVG icons.\n\n### Key features\n\n- 290+ native WordPress icons, including social logos\n- Use any custom SVG icon or graphic\n- Insert icons from your Media Library if SVG uploads are supported\n- Includes handy icon controls (link, rotate, alignment, colors, border, padding, margin, etc.)\n- Fully compatible with the Site Editor\n- No block library required 🎉\n- Built almost entirely with native WordPress components\n- Will get additional functionality as it's added to WordPress core\n- Register your own custom icon library. [Learn more](https://nickdiego.com/adding-custom-icons-to-the-icon-block/).\n\n## Extensibility\n\nThe Icon Block includes several extensibility features that allow you to tailor the block to meet your needs.\n\n### Hooks \u0026 Filters\n\n#### `iconBlock.icons`\n\nFilters all icons available in the built-in icon library. Use this filter to add or remove icons from the plugin. [Learn more](https://nickdiego.com/adding-custom-icons-to-the-icon-block/).\n\n#### `iconBlock.enableCustomIcons`\n\nDefaults to `true`, this filter allows you to enable or disable custom SVG icon functionality. When disabled, you are restricted from using the icon library.\n\n```\nwp.hooks.addFilter(\n\t'iconBlock.enableCustomIcons',\n\t'example-theme/disable-custom-icons',\n\t() =\u003e false\n);\n```\n\n### theme.json\n\nYou can easily disable border and spacing settings in the Editor UI if your theme includes a theme.json file.\n\n```\n{\n\t...\n\t\"settings\": {\n\t\t...\n\t\t\"blocks\": {\n\t\t\t\"outermost/icon-block\": {\n\t\t\t\t\"border\": {\n\t\t\t\t\t\"color\": false,\n\t\t\t\t\t\"radius\": false,\n\t\t\t\t\t\"style\": false,\n\t\t\t\t\t\"width\": false\n\t\t\t\t},\n\t\t\t\t\"spacing\": {\n\t\t\t\t\t\"margin\": false,\n\t\t\t\t\t\"padding\": false\n\t\t\t\t}\n\t\t\t},\n...\n```\n\n## Requirements\n\n- WordPress 6.5+\n- PHP 7.4+\n\n## Development\n\n1. Set up a local WordPress development environment.\n2. Clone / download this repository into the `wp-content/plugins` folder.\n3. Navigate to the `wp-content/plugins/icon-block` folder in the command line.\n4. Run `npm install` to install the plugin's dependencies within a `/node_modules/` folder.\n5. Run `composer install` to install the additional WordPress composer tools within a `/vendor/` folder.\n6. Run `npm run start` to compile and watch source files for changes while developing.\n\nRefer to `package.json` for additional commands.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fndiego%2Ficon-block","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fndiego%2Ficon-block","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fndiego%2Ficon-block/lists"}