{"id":26793232,"url":"https://github.com/beapi/acf-svg-icon","last_synced_at":"2025-10-09T22:06:29.860Z","repository":{"id":52856438,"uuid":"90953987","full_name":"BeAPI/acf-svg-icon","owner":"BeAPI","description":"Add svg icon selector for ACF field.","archived":false,"fork":false,"pushed_at":"2025-05-16T17:31:00.000Z","size":116,"stargazers_count":50,"open_issues_count":16,"forks_count":14,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-09-17T10:50:15.311Z","etag":null,"topics":["acf","acf-field","advanced-custom-fields","plugin","select2","svg","svg-icon-selector","svg-icons","wordpress","wordpress-plugin"],"latest_commit_sha":null,"homepage":"https://www.beapi.fr","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BeAPI.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2017-05-11T08:06:21.000Z","updated_at":"2025-03-28T15:05:23.000Z","dependencies_parsed_at":"2025-04-22T15:12:38.000Z","dependency_job_id":"eb1522a7-d98d-45be-82cb-c846ccb4e99c","html_url":"https://github.com/BeAPI/acf-svg-icon","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/BeAPI/acf-svg-icon","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BeAPI%2Facf-svg-icon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BeAPI%2Facf-svg-icon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BeAPI%2Facf-svg-icon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BeAPI%2Facf-svg-icon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BeAPI","download_url":"https://codeload.github.com/BeAPI/acf-svg-icon/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BeAPI%2Facf-svg-icon/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279002113,"owners_count":26083306,"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","status":"online","status_checked_at":"2025-10-09T02:00:07.460Z","response_time":59,"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","acf-field","advanced-custom-fields","plugin","select2","svg","svg-icon-selector","svg-icons","wordpress","wordpress-plugin"],"created_at":"2025-03-29T16:19:33.334Z","updated_at":"2025-10-09T22:06:29.822Z","avatar_url":"https://github.com/BeAPI.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Advanced Custom Fields: SVG Icon #\n\nThis enhance [Advanced Custom Field](https://www.advancedcustomfields.com/pro/) plugin by adding a custom field.\n\nThis ACF field is a select2 field in order to include your great fonts. It will allow you to select icons and then return the corresponding class icon.\n\n## Compatibility\n\nThis ACF field type is compatible with:\n* ACF 5.0.0 and up, that means the pro version.\n* ACF 4 (not supported).\n\n## Installation\n\n### via Composer\n\n1. Add a line to your repositories array: `{ \"type\": \"git\", \"url\": \"https://github.com/BeAPI/acf-svg-icon\" }`\n2. Add a line to your require block: `\"bea/acf-svg-icon\": \"dev-master\"`\n3. Run: `composer update`\n\n### Manual\n\n1. Copy the plugin folder into your plugins folder.\n2. Activate the plugin via the plugins admin page.\n3. Create a new field via ACF and select the SVG Icon selector.\n\n## How to ##\n\n### Upload SVG into library\n\nYou can upload media in your library, it must be an \u003cb\u003eSVG\u003c/b\u003e, and then it will be displayed into the SVG dropdown.\nIn this case, consider using [Scalable Vector Graphics (svg)](https://fr.wordpress.org/plugins/scalable-vector-graphics-svg) for security.\n\n### In your own theme ###\n\nTo load several SVGs from your theme (development), use the following filter to add the main sprite SVG file :\n\n```php\n\u003c?php add_filter( 'acf_svg_icon_filepath', 'bea_svg_icon_filepath' );\nfunction bea_svg_icon_filepath( $filepath ) {\n    if ( is_file( get_stylesheet_directory() . '/assets/icons/icons.svg' ) ) {\n        $filepath[] = get_stylesheet_directory() . '/assets/icons/icons.svg';\n    }\n    return $filepath;\n}\n```\n\n## Contributing ##\n\nIf you gonna change some JS or CSS, we use GULP in order to uglify and minify assets. So please do the following for your PR :\n1. install node modules : `npm install`\n2. install gulp dependencies : `npm install gulp`\n3. then minify assets : `gulp dist`\n\n## Changelog ##\n\n### 2.1.3 - 17 Jul 2023\n* FEATURE : Skip media type for displaying svgs as we use the URL\n\n### 2.1.2 - 17 Jul 2023\n* FIX : fix PHP fatal error in the REST API for ACF's values from the field\n\n### 2.1.1 - 12 Apr 2023\n* FEATURE : add french translation\n\n### 2.1.0 - 29 Nov 2021\n* FEATURE : return sprite name if multiple SVG sprites are registered\n* FIX : Replace `gulp-uglify` with `gulp-uglify-es`\n* CHORE : set required Node version in package.json\n\n### 2.0.4 - 28 Oct 2019\n* FEATURE : add filter `acf_svg_icon_parsed_svg` to filter the icons list\n* FIX : fix PHP fatal error with SVG inclusion\n* FIX : temporary fix an issue with acf_format method\n* IMPROVE : respect WP coding standards\n\n### 2.0.3 - 04 Feb 2019\n* FIX : Mixing custom and media sources\n\n### 2.0.2 - 04 Feb 2019\n* FIX : Return array in get_all_svg_files function (reverted in 2.0.3)\n\n### 2.0.1 - 19 Nov 2018\n* FEATURE [#8](https://github.com/BeAPI/acf-svg-icon/issues/8) :  improve performances on parsing svg from library\n* FEATURE [#9](https://github.com/BeAPI/acf-svg-icon/issues/9) :  upload custom SVGs\n\n### 1.2.1 - 21 Aug 2017\n* fix notice $acf-\u003eversion property undefined on ACF versions under 5.6\n* use built-in wrapper acf_get_setting('version') to retrieve version\n\n### 1.2.0 - 27 July 2017\n* Add compatibility for ACF 5.6.0 and more versions\n* Still keep compatibility for ACF 5.6.0 and lower versions\n* Add some custom CSS for a more beautiful admin UI\n* Now displaying the icon name, not anymore like a slug\n* Improve readme\n\n### 1.0.1 - 11 May 2017\n* Initial\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbeapi%2Facf-svg-icon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbeapi%2Facf-svg-icon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbeapi%2Facf-svg-icon/lists"}