Опис
Додајте врсту поља Font Awesome иконице у Advanced Custom Fields.
- Наведите које FontAwesome скупове иконица користити (Solid, Regular, Light, Thin, Duotone, Duotone Sharp, Brands и произвољне отпремљене иконице) (неке функције доступне су само са FontAwesome 5.x или 6.x иконицама)
- Направите сопствени филтрирани списак FontAwesome иконица за своја поља. Користите различите произвољне скупове иконица са различитим пољима
- Враћа елемент иконице, класу иконице, Unicode иконице или објекат који укључује елемент, класу, Unicode вредност и SVG податке (ако је примењиво)
- По жељи ставља Font Awesome у ред у подножју где је потребно (када се FontAwesome поље користи на страници))
- Интегрише се са FontAwesome GraphQL за учитавање ваших FontAwesome комплета, претрагу иконица и учитавање најновијег издања FontAwesome
Напомена: препоручује се да пустите овај додатак да стави у ред најновије издање Font Awesome у јавном делу, или да сами укључите најновије издање помоћу свог FontAwesome комплета, како би се иконице доступне у администрацији исправно приказивале у јавном делу сајта.
Усклађеност
Ова врста ACF поља усаглашена је са:
* ACF 5.7+
* FontAwesome 4.x, 5.x, 6.x и 7.x словним ликовима
Необавезна подешавања
Филтери
- ACFFA_always_enqueue_fa: вратите true да бисте увек стављали FontAwesome у ред у јавном делу, чак и ако се на страници не користе ACF FontAwesome поља. Тако ће се FontAwesome ставити у ред у заглављу уместо у подножју.
- ACFFA_admin_enqueue_fa: вратите false да бисте зауставили стављање FontAwesome у ред у администрацији. Корисно ако већ имате FontAwesome стављен у ред на други начин.
- ACFFA_get_icons: (важи само за FontAwesome 4.x и 5.x иконице) филтрира низ иконица и података о иконицама учитаних из базе података
- ACFFA_get_fa_url: филтрира URL који се користи за стављање FontAwesome у ред у јавном делу и администрацији сајта.
- ACFFA_override_major_version: филтер за ручно постављање „главног“ издања FontAwesome које се учитава (прихвата 4, 5 или 6). НАПОМЕНА: овај филтер мора бити регистрован пре било ког позива ACF функције get_field().
- ACFFA_fa_api_key: филтер за програмско постављање FontAwesome API кључа.
- ACFFA_fa_kit_token: филтер за програмско постављање жетона FontAwesome комплета.
Снимци екрана
Постављање
Уобичајено постављање:
- Умножите фасциклу
advanced-custom-fields-font-awesomeу фасциклуwp-content/plugins - Укључите додатак Font Awesome на администраторској страници додатака
- Направите ново поље преко ACF-а и изаберите врсту Font Awesome
Постављање у тему:
Ако сте аутор теме и желите да уградите овај додатак у своју тему, од издања 4.0.1 овај додатак је осмишљен да ради из директоријума теме.
И даље је боље користити нешто попут TGM Plugin Activation за укључивање обавезних/препоручених додатака у тему. Међутим, ако одлучите да уградите овај додатак, пратите ова упутства:
- Умножите фасциклу ‘advanced-custom-fields-font-awesome’ у фасциклу теме. По могућству у путању као што је ‘includes/advanced-custom-fields-font-awesome’
- Укључите додатак из functions.php своје теме. Пример:
include_once( get_stylesheet_directory() . '/includes/advanced-custom-fields-font-awesome/acf-font-awesome.php' );
Додаци укључени на овај начин не могу да примају редовна ажурирања додатака. Програмер теме је тај који треба да објављује ова ажурирања додатка својим корисницима.
Међутим, овај додатак покушава да обавести корисника ако користи застарело издање додатка. Застареле поставке у теми приказују администраторско обавештење на врху странице додатака у Вордпрес администрацији. Порука гласи:
Доступно је ново издање додатка Advanced Custom Fields: Font Awesome. Постављено издање: {current_version}, најновије издање: {latest_version}
Изгледа да је овај додатак уграђен у вашу тему: ({theme_name}) и не може да прима ажурирања. Препоручује се да се за ажурирања обратите аутору теме. Као друга могућност, овај додатак можете поставити из ризнице Вордпрес додатака да бисте добили најновије издање.
Ако корисник постави овај додатак из ризнице додатака, то издање додатка замениће оно постављено у директоријуму теме.
Ова порука обавештења може да се филтрира, тако да је можете прилагодити да боље представља како решавате ажурирања додатака за кориснике своје теме. Погледајте пример испод:
function my_acffa_update_message( $out_of_date_message, $current_version, $latest_version ) {
// Customize the message here
return $out_of_date_message;
}
add_filter( 'ACFFA_theme_install_update_message', 'my_acffa_update_message', 10, 3 );
ЧПП
-
Где да пријавим безбедносне грешке пронађене у овом додатку?
-
Безбедносне грешке пронађене у изворном коду додатка Advanced Custom Fields: Font Awesome Field пријавите кроз Patchstack програм за откривање рањивости. Тим Patchstack ће вам помоћи око провере, доделе CVE ознаке и обавестиће програмере овог додатка.
Рецензије
19. децембар 2025.
1 одговор
Once an excellent plugin, then for a year or two mostly abandoned with lacking support for newer FA styles. As of December 2025 it is now updated and active again thanks to a new contributor, supporting all the latest FA7 styles. Kudos for bringing this useful plugin back to life.
23. август 2023.
1 одговор
It's one of those plugins, that does a job perfectly and discreetly, without trying to dominate the dashboard or upsell.After adding it for yet another site, I thought I could at least write a review in appreciation, so thanks Matt, for your time and efforts, it's appreciated.
26. јул 2023.
Excellent Support
11. фебруар 2023.
I used the plugin within my own custom plugin and was impressed with the quality of the code and the functionality of the plugin. I asked the developer for support and he got back to me within hours.Advised.
20. јул 2022.
Does what it says on the tin. I use this frequently when building bespoke solutions, and it always gets the job done.
7. април 2022.
Simply a brilliant plugin.
I use this for all of my custom WordPress themes.
Works great, and if not, good and fast support is on the way 🙂
Сарадници и градитељи
„Advanced Custom Fields: Font Awesome Field“ је софтвер отвореног кода. Следећи људи су допринели овом додатку.
Сарадници
„Advanced Custom Fields: Font Awesome Field“ је преведен на 5 језика. Хвала преводиоцима на њиховим доприносима.
Преведите „Advanced Custom Fields: Font Awesome Field“ на свој језик.
Заинтересовани сте за развој?
Прегледајте кôд, погледајте SVN складиште или се претплатите на дневник развоја преко RSS-а.
Дневник измена
6.2.0
- Ново: при коришћењу FontAwesome комплета, претрага иконица и приказ иконица сада приказују само иконице и стилове који су стварно укључени у ваш комплет, уместо целе FontAwesome библиотеке.
6.1.4
- Безбедност: проверавач упита FontAwesome API-ја замењен је захтевом који прави сервер.
- Исправка грешке: резултати претраге FontAwesome 5.x иконица груписани су под погрешан стил иконица, па су се исправно приказивале само иконице брендова.
- Додато: претрага FontAwesome 5.x иконица сада поклапа и FontAwesome појмове/надимке за претрагу иконица (нпр. претрага „test“ сада проналази иконицу „vial“), а не само називе иконица.
6.1.3
- Безбедност: додатно ојачана функција упита FontAwesome API-ја.
6.1.2
- Безбедност: ојачана функција упита FontAwesome API-ја против неовлашћене употребе.
6.1.1
- Додато: подршка за нове FontAwesome 7.3.0 Pro+ породице иконица: Pixel, Mosaic, Vellum, Slab Duo и Slab Press Duo.
6.0.4
- Исправка грешке: повећан z-index искачућег прозора за избор иконице ради избегавања сукоба са бочном траком ACF блока.
6.0.3
- Додато: FA иконица при избору новог поља.
- Исправка грешке: могуће је очистити избор подразумеване иконице.
6.0.2
- Исправка грешке: исправљен проблем када није изабрана ниједна породица иконица.
6.0.1
- Исправка грешке: исправљен проблем где нови бирач иконица није дозвољавао брисање избора када је укључена могућност празне вредности.
6.0.0
- Нови бирач FontAwesome 7.x иконица који покреће званична веб компонента FontAwesome Icon Chooser за богатије искуство избора иконица.
- Функција „Градитељ скупова иконица“ застарела је за кориснике FontAwesome 7.x. Градитељ скупова иконица и даље ради као и раније за кориснике FontAwesome 4.x, 5.x и 6.x.
- Додата подршка за нову FontAwesome породицу иконица „Graphite“.
- Ажурирана усаглашеност „Requires at least“: FontAwesome 7.x функције захтевају Вордпрес 6.5+ због подршке за модуле скрипти.
5.0.2
Напомена: следеће веће ажурирање донеће измене у начину избора иконица при коришћењу FontAwesome 7.x, ради коришћења нових и будућих функција FontAwesome-а. Нажалост, то значи да ће функција „Градитељ скупова иконица“ постати застарела, ради бољег усклађивања овог додатка са FontAwesome екосистемом. Ова измена утиче само на кориснике FontAwesome 7.x иконица. Градитељ скупова иконица наставиће да ради као и са претходним издањима FontAwesome. Радо ћемо примити ваше мишљење о овој измени.
- Исправка грешке: иконице произвољних комплета додате у учитавање скупа Font Awesome 7.x иконица.
- Безбедност: чишћење и обезбеђивање више излаза.
5.0.1
Напомена: следеће ажурирање донеће измене у начину избора иконица при коришћењу FontAwesome 7.x, ради коришћења нових и будућих функција FontAwesome-а. Нажалост, то значи да ће функција „Градитељ скупова иконица“ постати застарела, ради бољег усклађивања овог додатка са FontAwesome екосистемом. Ова измена утиче само на кориснике FontAwesome 7.x иконица. Градитељ скупова иконица наставиће да ради као и са претходним издањима FontAwesome. Радо ћемо примити ваше мишљење о овој измени.
- Исправка грешке: најновије FA издање сада се исправно проверава и ажурира при чувању подешавања.
- Исправка грешке: поље се није исправно учитавало унутар ACF блока који користи blockVersion 3.
5.0.0
- Додата подршка за FontAwesome 7.x иконице и нове стилове иконица
- Ажурирана интеграција са FontAwesome GraphQL API-јем ради подршке за FontAwesome 7.x иконице и комплете
- Због дугачког списка скупова иконица при уређивању поља, поља за потврду замењена су select2 пољем за вишеструки избор.
4.1.2
- Исправка грешке: домен текста додатка може се учитати прерано ако се ACF поља користе пре Вордпрес ‘init’
4.1.1
- Исправка грешке: скупови иконица нису исправно чувани при уређивању поља FontAwesome иконице
4.1.0
- Додата подршка за Duotone Sharp иконице
4.0.9
- Исправка грешке: неке SVG иконице изабране пре ажурирања 4.0.8 нису се исправно приказивале.
- Исправка грешке: неке произвољне иконице које су изабране пре ажурирања 4.0.8 нису се исправно приказивале.
- Исправка грешке: решено могуће PHP упозорење на администраторским екранима за уређивање чланака при враћању са FontAwesome 6 на скупове иконица 5.
4.0.8
- Исправка грешке: PHP упозорење при враћању неких произвољних иконица као објекта
- Додата подршка за враћање SVG-а обликованог од стране FontAwesome-а за произвољне и duotone иконице уместо прављења у додатку. Раније изабране иконице морају се поново изабрати да би користиле овај побољшани SVG.
4.0.7
- Додата подршка за FontAwesome иконице породице „Sharp“
- Додата подршка за duotone иконице које корисници отпреме у комплете
- Ажурирано покретање иконица ради боље усаглашености са REST API-јем и разним градитељима сајтова трећих страна који се интегришу са ACF пољима.
- Додат филтер (ACFFA_fa_api_key) који омогућава програмско постављање FontAwesome API кључа.
- Додат филтер (ACFFA_fa_kit_token) који омогућава програмско постављање жетона FontAwesome комплета.
- Ограничена улога Select2 аргумената ‘dropdownCssClass’ и ‘containerCssClass’ ради избегавања сукоба са другим додацима који користе старија/непотпуна издања Select2
4.0.6
- Исправљено упозорење у вези са PHP 8.2
4.0.5
- Исправљен проблем усаглашености са ACF 6.1+ због ког се страница подешавања овог додатка кварила
- Исправљена грешка у логици за „уграђивање“ овог додатка у тему која је изазивала проблеме са учитавањем ресурса у неким окружењима
4.0.4
- Исправљена грешка где су упити ка FontAwesome API-ју истицали за неке кориснике, што је изазивало проблеме са претрагом иконица у администрацији
4.0.3
- Аутоматско освежавање кеша 4.x и 5.x иконица при чувању подешавања
- Додатни низови за превод
4.0.2
- Исправљена грешка где су подаци о FontAwesome 5.x иконицама погрешно учитавали FontAwesome 6.x податке
- Уклоњене неке зависности од jsDelivr за податке о FontAwesome 5.x иконицама
4.0.1
- Исправљена грешка где страница FontAwesome подешавања није исправно учитавала CSS/JS ресурсе на Вордпрес поставкама на другим језицима.
- Додата подршка да аутори тема уграде овај додатак у тему ( погледајте упутства за постављање )
- Повећан број „резервног“ издања FontAwesome 6 да одговара издању 6.0.0
4.0.0
- Додата подршка за FontAwesome 6 иконице
- Додата подршка за FontAwesome комплете, укључујући произвољне отпремљене иконице
- Сада користи FontAwesome GraphQL API за бржу претрагу и приближно поклапање
- Додат нови режим усаглашености ради лакшег ажурирања са v4 и v5 иконица
3.1.2
- Исправљен проблем усаглашености са ACF 5.10+
- Исправљена упозорења о застарелости у PHP 8, хвала Levi Cole на pull request-у
3.1.1
- Исправљена грешка где Duotone иконице нису биле доступне постојећим корисницима овог додатка због кешираних издања иконица из времена пре него што је додатак могао исправно да рашчлањује duotone иконице.
3.1.0
- Додата подршка за нове FontAwesome Duotone иконице (потребна FontAwesome Pro претплата)
- Додата подршка за ACF филтер ‘acf/settings/capability’ на страници подешавања
3.0.2
- Исправљена грешка која је изазивала PHP упозорење о недефинисаној константи
3.0.1
- Исправљена грешка где се FontAwesome поље није успешно регистровало на сајтовима који присиљавају ACF да се рано покрене (обично позивањем функције get_field у датотеци functions.php теме)
3.0.0
- НАПОМЕНА: при надоградњи са претходног издања овог додатка, „главно издање“ FontAwesome остаће на v4 ради усаглашености са постојећим интеграцијама. МЕЂУТИМ, ако надограђујете са веома старог издања овог додатка, можда неће бити могуће открити претходну поставку, па ћете морати ручно да подесите овај додатак да користи FontAwesome v4 у новом администраторском делу подешавања.
- Додата подршка за нове бесплатне и Pro FontAwesome 5.x скупове иконица
- Додат нови градитељ „произвољног скупа иконица“ који омогућава прављење FontAwesome ACF поља са ограниченим скупом иконица појединачно изабраних са целог списка FontAwesome иконица. Пример: направите произвољни скуп иконица ограничен само на иконице брендова друштвених мрежа
- Додате нове могућности поља за ограничавање који скупови иконица ( Brands, Regular, Lite, Solid ) су дозвољени у пољу (важи само за FontAwesome v5)
- Додавање новог администраторског изборника „FontAwesome подешавања“ у главном ACF изборнику за опште могућности подешавања.
- Побољшања брзине учитавања странице (иконице се не учитавају у конструктору поља)
- Уклањање подршке за ACF v4 сада када је изашао v5 са бесплатним издањем
2.1.2
- Исправљена грешка где филтер ACFFA_get_icons није коришћен у wp-admin при преузимању иконица.
2.1.1
- Исправљена грешка која је утицала на кориснике који нису ажурирали на 2.1.0 пре него што је jsDelivr додао FontAwesome 5.x на свој CDN, где су се учитавале 5.x иконице и кварила функционалност
2.1.0
- Спречена сва аутоматска ажурирања на издање 5.x FontAwesome која би могла да покваре функционалност додатка и доведу до неисправних иконица на сајтовима који тренутно користе FontAwesome 4.x иконице.
2.0.9
- Исправљена грешка где су поља са празном вредношћу направљена у 1.x овог додатка враћала ниску ‘null’ уместо логичке вредности false при коришћењу у 2.x издањима додатка.
2.0.8
- Исправљена грешка где поља означена са „дозволи празно“ у acf v5 нису приказивала (x) за уклањање изабране могућности у пољу
2.0.7
- Исправљена грешка са FA пољима додељеним ставкама изборника + даље преуређивање JS-а за ACF v5
2.0.6
- Преуређен JS ради поједностављења кода и исправке грешака где се Chosen или Select2 поља нису покретала у разним подешавањима поља/подпоља и могућностима приказа.
2.0.5
- Исправљена грешка са ACF језичцима + FontAwesome пољима где се Chosen/Select2 није покретао после првог приказаног језичка
2.0.4
- Додат филтер (ACFFA_always_enqueue_fa) који омогућава да се FontAwesome увек стави у ред у јавном делу сајта, чак и ако се на страници не користе ACF FontAwesome поља.
2.0.3
- Исправљена грешка где је поље подешено да враћа „Објекат иконице“ уместо тога враћало низ
2.0.2
- Исправљена грешка која је утицала на поља за избор када се користе заједно са Font Awesome пољем у понављачу (ACF v5)
2.0.1
- Исправљена грешка која је изазивала неусаглашеност са ACF Clone пољима (ACF v5)
- Исправљена грешка где избор подразумеваних иконица није могао да се поништи при прављењу FontAwesome поља (ACF v5)
2.0.0
- Потпуно преписан додатак ради поједностављења кода и бољег придржавања стандарда кодирања и најбољих пракси Вордпреса и Advanced Custom Fields
- Додата могућност искључивања већег прегледа иконице приказаног уз FontAwesome поља за избор
1.7.4
- Исправљена неусаглашеност са најновијим ACF 5 + Select2 v4.x
1.7.3
- Better Font Awesome library ажурирана на најновије издање
- „Резервни“ ACF словни лик ажуриран на 4.6.3
- Исправка грешке: преширока CSS правила утицала су на групе поља које нису font awesome
- Исправка грешке: select2 се није учитавао на новим fontawesome иконицама све до чувања поља
1.7.2
- Исправка грешке: PHP обавештење при покушају приступа својству вредности ‘null’
1.7.1
- Ажурирана Better Font Awesome Library ради боље усаглашености са додатком Better Font Awesome
- Измењен начин откривања ACF 4/5 ради боље интеграције са додатком Better Font Awesome
- Исправка грешке: погрешна иконица прегледа појављивала се у делу за прављење ACF произвољних поља
1.7
- Додата могућност да подразумевано не буде изабрана ниједна иконица
- Боље руковање ставкама ‘null’ или „без избора“
- Исправљена грешка где се подразумевана иконица није приказивала у администрацији ако је изабрана врста враћања ‘unicode’
1.6.4
- Разна побољшања брзине JS-а
- Исправљена грешка где се select2 није покретао на ставкама понављача додатим између редова (помоћу иконице плус на крају реда понављача)
1.6.3
- Исправљене грешке путања ресурса при укључивању овог проширења из теме уместо из директоријума додатака
1.6.2
- Поништавање измена из 1.6.1 после пријаве више грешака. Проблеми неусаглашености са Better Font Awesome исправљени су у коду тог додатка.
1.6.1
- Решавање проблема неусаглашености између овог додатка и додатка Better Font Awesome
1.6
- Разне исправке JS-а ради исправног циљања ACF поља у DOM-у (на основу измена у структури ACF-а). Ово би требало да реши проблеме са дуплим или недостајућим select2 пољима при избору font awesome иконица.
1.5
- Нова функција: интеграција са Better Font Awesome Library ради аутоматског коришћења најновијег издања Font Awesome иконица
1.4
- Уграђени FontAwesome ажуриран на издање 4.2
1.3
- Додата подршка за ACF издање 5.x
1.2
- Додата подршка за нове иконице у FontAwesome 4.1
- Уграђени FontAwesome ажуриран на издање 4.1
1.1.2
- Исправљен превише одређен JS селектор због ког се иконице прегледа нису учитавале на страницама појмова таксономије
1.1.1
- Исправљена JS грешка која је кварила падајуће спискове условних поља
1.1.0
- Додата подршка за коришћење у пољима понављача
- Додата подршка за коришћење у пољима флексибилног садржаја
- Додат преглед иконице уживо на екран за прављење поља
- Исправљене разне грешке при покретању Select2 на динамички додатим пољима
1.0.0
- Прво издање.