RO CSVI supports import and export of Joomla core custom fields. In this document we explain about how to import Advanced Custom Fields for Joomla.
There are around 28 custom fields which are supported by Advanced custom fields. Each of these custom fields are explained in this document.
Things to remember before starting Joomla Advanced Custom Fields import for an article.
1. Import of Joomla custom fields for an article is done using a Joomla Content import template.
2. Once you have the custom fields created, Update your available fields.
3. You should have enabled the Joomla! Custom Fields extension for RO CSVI plugin from Extensions -> Plugins.
4. All settings for a custom field should be done in the System - Advanced Custom Fields plugin from Extensions -> Plugins.
Here is the list of Advanced custom fields
- ACF - Bing map
- ACF - Country
- ACF - Currency
- ACF - Daily motion
- ACF - Download button
- ACF - Email
- ACF - Facebook
- ACF - Facebook video
- ACF - File Upload
- ACF - Google map
- ACF - Gravatar
- ACF - HTML5 Audio
- ACF - HTML5 Video
- ACF - IFrame
- ACF - Module loader
- ACF - OpenStreetMap
- ACF - PHP
- ACF - PayPal
- ACF - Progress Bar
- ACF - QR Code
- ACF - SoundCloud
- ACF - Telephone
- ACF - Timepicker
- ACF - True/False
- ACF - Twitter
- ACF - URL
- ACF - Vimeo
- ACF- WhatsApp Click to Chat
- ACF - Youtube
ACF - Bing map
First step is to Set API Key for Bing map. From Joomla plugin manager select Type as Fields and look for Fields - ACF Bing map. Set Bing Maps API Key and save. You can also do this setting using System - Advanced Custom fields plugin.
Click on the settings icon
Now that Bing map settings are done, Create an ACF Bing map custom field from Joomla Fields page for Joomla Content.
Run the import with below sample content
alias;catid;bing-map
sample-article;2;"17.465367,78.500378"
ACF - Country
Create an Advanced Custom Field of type Country using Advanced Custom Fields
Run import with below content. Do remember that you need to use the character code of the country to be imported. Here IN is for India.
alias;catid;country
sample-article;2;IN
Check the other country list supported by Advanced custom fields
AF - Afghanistan
AX - Aland Islands
AL - Albania
DZ - Algeria
AS - American Samoa
AD - Andorra
AO - Angola
AI - Anguilla
AQ - Antarctica
AG - Antigua and Barbuda
AR - Argentina
AM - Armenia
AW - Aruba
AU - Australia
AT - Austria
AZ - Azerbaijan
BS - Bahamas
BH - Bahrain
BD - Bangladesh
BB - Barbados
BY - Belarus
BE - Belgium
BZ - Belize
BJ - Benin
BM - Bermuda
BT - Bhutan
BO - Bolivia
BA - Bosnia and Herzegovina
BW - Botswana
BV - Bouvet Island
BR - Brazil
IO - British Indian Ocean Territory
BN - Brunei Darussalam
BG - Bulgaria
BF - Burkina Faso
BI - Burundi
KH - Cambodia
CM - Cameroon
CA - Canada
CV - Cape Verde
KY - Cayman Islands
CF - Central African Republic
TD - Chad
CL - Chile
CN - China
CX - Christmas Island
CC - Cocos (Keeling) Islands
CO - Colombia
KM - Comoros
CG - Congo
CD - Congo, The Democratic Republic of the
CK - Cook Islands
CR - Costa Rica
CI - Cote d'Ivoire
HR - Croatia
CU - Cuba
CUR - Curaçao
CY - Cyprus
CZ - Czech Republic
DK - Denmark
DJ - Djibouti
DM - Dominica
DO - Dominican Republic
EC - Ecuador
EG - Egypt
SV - El Salvador
GQ - Equatorial Guinea
ER - Eritrea
EE - Estonia
ET - Ethiopia
FK - Falkland Islands (Malvinas)
FO - Faroe Islands
FJ - Fiji
FI - Finland
FR - France
GF - French Guiana
PF - French Polynesia
TF - French Southern Territories
GA - Gabon
GM - Gambia
GE - Georgia
DE - Germany
GH - Ghana
GI - Gibraltar
GR - Greece
GL - Greenland
GD - Grenada
GP - Guadeloupe
GU - Guam
GT - Guatemala
GG - Guernsey
GN - Guinea
GW - Guinea-Bissau
GY - Guyana
HT - Haiti
HM - Heard Island and McDonald Islands
VA - Holy See (Vatican City State)
HN - Honduras
HK - Hong Kong
HU - Hungary
IS - Iceland
IN - India
ID - Indonesia
IR - Iran, Islamic Republic of
IQ - Iraq
IE - Ireland
IM - Isle of Man
IL - Israel
IT - Italy
JM - Jamaica
JP - Japan
JE - Jersey
JO - Jordan
KZ - Kazakhstan
KE - Kenya
KI - Kiribati
KP - Korea, Democratic People's Republic of
KR - Korea, Republic of
KW - Kuwait
KG - Kyrgyzstan
LA - Lao People's Democratic Republic
LV - Latvia
LB - Lebanon
LS - Lesotho
LR - Liberia
LY - Libyan Arab Jamahiriya
LI - Liechtenstein
LT - Lithuania
LU - Luxembourg
MO - Macao
MK - Macedonia
MG - Madagascar
MW - Malawi
MY - Malaysia
MV - Maldives
ML - Mali
MT - Malta
MH - Marshall Islands
MQ - Martinique
MR - Mauritania
MU - Mauritius
YT - Mayotte
MX - Mexico
FM - Micronesia, Federated States of
MD - Moldova, Republic of
MC - Monaco
MN - Mongolia
ME - Montenegro
MS - Montserrat
MA - Morocco
MZ - Mozambique
MM - Myanmar
NA - Namibia
NR - Nauru
NP - Nepal
NL - Netherlands
AN - Netherlands Antilles
NC - New Caledonia
NZ - New Zealand
NI - Nicaragua
NE - Niger
NG - Nigeria
NU - Niue
NF - Norfolk Island
NM - North Macedonia
MP - Northern Mariana Islands
NO - Norway
OM - Oman
PK - Pakistan
PW - Palau
PS - Palestinian Territory
PA - Panama
PG - Papua New Guinea
PY - Paraguay
PE - Peru
PH - Philippines
PN - Pitcairn
PL - Poland
PT - Portugal
PR - Puerto Rico
QA - Qatar
RE - Reunion
RO - Romania
RU - Russian Federation
RW - Rwanda
SH - Saint Helena
KN - Saint Kitts and Nevis
LC - Saint Lucia
PM - Saint Pierre and Miquelon
VC - Saint Vincent and the Grenadines
WS - Samoa
SM - San Marino
ST - Sao Tome and Principe
SA - Saudi Arabia
SN - Senegal
RS - Serbia
SC - Seychelles
SL - Sierra Leone
SG - Singapore
SK - Slovakia
SI - Slovenia
SB - Solomon Islands
SO - Somalia
ZA - South Africa
GS - South Georgia and the South Sandwich Islands
ES - Spain
LK - Sri Lanka
SD - Sudan
SS - South Sudan
SR - Suriname
SJ - Svalbard and Jan Mayen
SZ - Swaziland
SE - Sweden
CH - Switzerland
SY - Syrian Arab Republic
TW - Taiwan
TJ - Tajikistan
TZ - Tanzania, United Republic of
TH - Thailand
TL - Timor-Leste
TG - Togo
TK - Tokelau
TO - Tonga
TT - Trinidad and Tobago
TN - Tunisia
TR - Turkey
TM - Turkmenistan
TC - Turks and Caicos Islands
TV - Tuvalu
UG - Uganda
UA - Ukraine
AE - United Arab Emirates
GB - United Kingdom
US - United States
UM - United States Minor Outlying Islands
UY - Uruguay
UZ - Uzbekistan
VU - Vanuatu
VE - Venezuela
VN - Vietnam
VG - Virgin Islands, British
VI - Virgin Islands, U.S.
WF - Wallis and Futuna
EH - Western Sahara
YE - Yemen
ZM - Zambia
ZW - Zimbabwe
ACF-Currency
Create a custom field of type Currency using Advanced Custom Fields
Import using the below sample content. Use the three letter code for the currency. Here INR is for Indian currency.
alias;catid;country
first-article;2;INR
The list of other currency codes supported by Advanced Custom fields
AFN - AFN (Afghan Afghani)
ALL - ALL (Albanian Lek)
DZD - DZD (Algerian Dinar)
AOA - AOA (Angolan Kwanza)
ARS - ARS (Argentine Peso)
AMD - AMD (Armenian Dram)
AWG - AWG (Aruban Florin)
AUD - AUD (Australian Dollar)
AZN - AZN (Azerbaijani Manat)
BSD - BSD (Bahamian Dollar)
BHD - BHD (Bahraini Dinar)
BDT - BDT (Bangladeshi Taka)
BBD - BBD (Barbadian Dollar)
BYN - BYN (Belarusian Ruble)
BYR - BYR (Belarusian Ruble (pre-2016))
BZD - BZD (Belize Dollar)
BMD - BMD (Bermudan Dollar)
BTN - BTN (Bhutanese Ngultrum)
BTC - BTC (Bitcoin)
BOB - BOB (Bolivian Boliviano)
BAM - BAM (Bosnia-Herzegovina Convertible Mark)
BWP - BWP (Botswanan Pula)
BRL - BRL (Brazilian Real)
GBP - GBP (British Pound Sterling)
BND - BND (Brunei Dollar)
BGN - BGN (Bulgarian Lev)
BIF - BIF (Burundian Franc)
XOF - XOF (CFA Franc BCEAO)
XAF - XAF (CFA Franc BEAC)
XPF - XPF (CFP Franc)
KHR - KHR (Cambodian Riel)
CAD - CAD (Canadian Dollar)
CVE - CVE (Cape Verdean Escudo)
KYD - KYD (Cayman Islands Dollar)
CLP - CLP (Chilean Peso)
CLF - CLF (Chilean Unit of Account (UF))
CNY - CNY (Chinese Yuan)
COP - COP (Colombian Peso)
KMF - KMF (Comorian Franc)
CDF - CDF (Congolese Franc)
CRC - CRC (Costa Rican Colón)
HRK - HRK (Croatian Kuna)
CUC - CUC (Cuban Convertible Peso)
CUP - CUP (Cuban Peso)
CZK - CZK (Czech Republic Koruna)
DKK - DKK (Danish Krone)
DJF - DJF (Djiboutian Franc)
DOP - DOP (Dominican Peso)
XCD - XCD (East Caribbean Dollar)
EGP - EGP (Egyptian Pound)
ERN - ERN (Eritrean Nakfa)
EEK - EEK (Estonian Kroon)
ETB - ETB (Ethiopian Birr)
EUR - EUR (Euro)
FKP - FKP (Falkland Islands Pound)
FJD - FJD (Fijian Dollar)
GMD - GMD (Gambian Dalasi)
GEL - GEL (Georgian Lari)
GHS - GHS (Ghanaian Cedi)
GIP - GIP (Gibraltar Pound)
XAU - XAU (Gold Ounce)
GTQ - GTQ (Guatemalan Quetzal)
GGP - GGP (Guernsey Pound)
GNF - GNF (Guinean Franc)
GYD - GYD (Guyanaese Dollar)
HTG - HTG (Haitian Gourde)
HNL - HNL (Honduran Lempira)
HKD - HKD (Hong Kong Dollar)
HUF - HUF (Hungarian Forint)
ISK - ISK (Icelandic Króna)
INR - INR (Indian Rupee)
IDR - IDR (Indonesian Rupiah)
IRR - IRR (Iranian Rial)
IQD - IQD (Iraqi Dinar)
ILS - ILS (Israeli New Sheqel)
JMD - JMD (Jamaican Dollar)
JPY - JPY (Japanese Yen)
JEP - JEP (Jersey Pound)
JOD - JOD (Jordanian Dinar)
KZT - KZT (Kazakhstani Tenge)
KES - KES (Kenyan Shilling)
KWD - KWD (Kuwaiti Dinar)
KGS - KGS (Kyrgystani Som)
LAK - LAK (Laotian Kip)
LVL - LVL (Latvian Lats)
LBP - LBP (Lebanese Pound)
LSL - LSL (Lesotho Loti)
LRD - LRD (Liberian Dollar)
LYD - LYD (Libyan Dinar)
LTL - LTL (Lithuanian Litas)
MOP - MOP (Macanese Pataca)
MKD - MKD (Macedonian Denar)
MGA - MGA (Malagasy Ariary)
MWK - MWK (Malawian Kwacha)
MYR - MYR (Malaysian Ringgit)
MVR - MVR (Maldivian Rufiyaa)
MTL - MTL (Maltese Lira)
IMP - IMP (Manx pound)
MRO - MRO (Mauritanian Ouguiya)
MUR - MUR (Mauritian Rupee)
MXN - MXN (Mexican Peso)
MDL - MDL (Moldovan Leu)
MNT - MNT (Mongolian Tugrik)
MAD - MAD (Moroccan Dirham)
MZN - MZN (Mozambican Metical)
MMK - MMK (Myanma Kyat)
NAD - NAD (Namibian Dollar)
NPR - NPR (Nepalese Rupee)
ANG - ANG (Netherlands Antillean Guilder)
TWD - TWD (New Taiwan Dollar)
NZD - NZD (New Zealand Dollar)
NIO - NIO (Nicaraguan Córdoba)
NGN - NGN (Nigerian Naira)
KPW - KPW (North Korean Won)
NOK - NOK (Norwegian Krone)
OMR - OMR (Omani Rial)
PKR - PKR (Pakistani Rupee)
XPD - XPD (Palladium Ounce)
PAB - PAB (Panamanian Balboa)
PGK - PGK (Papua New Guinean Kina)
PYG - PYG (Paraguayan Guarani)
PEN - PEN (Peruvian Nuevo Sol)
PHP - PHP (Philippine Peso)
XPT - XPT (Platinum Ounce)
PLN - PLN (Polish Zloty)
QAR - QAR (Qatari Rial)
RON - RON (Romanian Leu)
RUB - RUB (Russian Ruble)
RWF - RWF (Rwandan Franc)
SHP - SHP (Saint Helena Pound)
SVC - SVC (Salvadoran Colón)
WST - WST (Samoan Tala)
SAR - SAR (Saudi Riyal)
RSD - RSD (Serbian Dinar)
SCR - SCR (Seychellois Rupee)
SLL - SLL (Sierra Leonean Leone)
XAG - XAG (Silver Ounce)
SGD - SGD (Singapore Dollar)
SBD - SBD (Solomon Islands Dollar)
SOS - SOS (Somali Shilling)
ZAR - ZAR (South African Rand)
KRW - KRW (South Korean Won)
XDR - XDR (Special Drawing Rights)
LKR - LKR (Sri Lankan Rupee)
SDG - SDG (Sudanese Pound)
SRD - SRD (Surinamese Dollar)
SZL - SZL (Swazi Lilangeni)
SEK - SEK (Swedish Krona)
CHF - CHF (Swiss Franc)
SYP - SYP (Syrian Pound)
STD - STD (São Tomé and Príncipe Dobra)
TJS - TJS (Tajikistani Somoni)
TZS - TZS (Tanzanian Shilling)
THB - THB (Thai Baht)
TOP - TOP (Tongan Pa?anga)
TTD - TTD (Trinidad and Tobago Dollar)
TND - TND (Tunisian Dinar)
TRY - TRY (Turkish Lira)
TMT - TMT (Turkmenistani Manat)
UGX - UGX (Ugandan Shilling)
UAH - UAH (Ukrainian Hryvnia)
AED - AED (United Arab Emirates Dirham)
USD - USD (United States Dollar)
UYU - UYU (Uruguayan Peso)
UZS - UZS (Uzbekistan Som)
VUV - VUV (Vanuatu Vatu)
VEF - VEF (Venezuelan Bolívar Fuerte)
VND - VND (Vietnamese Dong)
YER - YER (Yemeni Rial)
ZMW - ZMW (Zambian Kwacha)
ZMK - ZMK (Zambian Kwacha (pre-2013))
ZWL - ZWL (Zimbabwean Dollar)
ACF - Daily motion
Create a custom field of type Daily motion using Advanced Custom Fields
Run import with below content. The Daily motion custom field supports the import of a video URL for an article.
alias;catid;daily-motion
sample-article;2;https://www.dailymotion.com/video/x75iqs7
ACF - Download button
Create a custom field of type Download using Advanced Custom Fields. Set the Directory path from where the imported file has to be downloaded. In this case Directoy is set to images/stories/virtuemart/product/
Run the import with below sample content. Where the file test.jpg resides in the directory images/stories/virtuemart/product/
alias;catid;download
sample-article;2;test.jpg
ACF - Email
Create a custom field of type Email using Advanced Custom Fields
alias;catid;email
sample-article;2;This email address is being protected from spambots. You need JavaScript enabled to view it.
ACF - Facebook
Create a custom field of type Facebook using Advanced Custom Fields
Set the Facebook page URL in import content
alias;catid;facebook
sample-article;2;https://www.facebook.com/test.user
ACF - Facebook video
Create a custom field of type Facebook Video using Advanced Custom Fields. This custom field takes URL of videos from Facebook.
Sample import content to load video from Facebook URL
alias;catid;facebook-video
sample-article;2;https://www.facebook.com/146044558739138/videos/1101368200062805
ACF - File Upload
Create a custom field of type File upload using Advanced Custom Fields. Upload the image to folder /media/acfupload folder or to the folder set in Upload folder setting and then use the image name in import file.
Sample import content to upload file 9739.jpg.
alias;catid;file-upload
sample-article;2;9739.jpg
ACF - Google map
1. Generate API Key from https://console.cloud.google.com/google/maps-apis/overview
2. Set a Google map API in Plugin Fields - ACF Google Map plugin from Extensions -> Plugins
3. Create a custom field with name Google map using Advanced Custom Fields
Set the cordinates in the import file for the custom field
alias;catid;google-map
sample-article;2;"17.465367,78.500378"
ACF - Gravatar
Create a custom field of type Gravatar using Advanced Custom Fields
In the import file set the email id from where the gravatar has to be loaded
alias;catid;gravatar
sample-article;2;This email address is being protected from spambots. You need JavaScript enabled to view it.
ACF - HTML5 Audio
1. Create a custom field of type HTML5 Audio using Advanced Custom Fields
2. Upload the audio to needed path. Here it is uploaded to media/acfupload/ folder
In the import file set the name of the audio mp3 file with path.
alias;catid;html-audio
sample-article;2;media/acfupload/audio.mp3
ACF - HTML5 Video
1. Create a custom field of type HTML5 Video using Advanced Custom Fields
2. Upload the audio to needed path. Here it is uploaded to media/acfupload/ folder
In the import file set the name of the video mp4 file with path.
alias;catid;html-video
sample-article;2;media/acfupload/video.mp4
ACF - IFrame
Create a custom field of the type IFrame using Advanced Custom Fields
In the IFrame field set the URL to be loaded in an IFrame. Here in the sample content google.com url is used to load in iframe.
alias;catid;iframe
sample-article;2;http://www.google.com
ACF - Module loader
Create a custom field of type Module loader using Advanced Custom Fields. This field is for loading a specific module on frontend based on the id imported.
In the import file set the module id for Module loader custom field. Here the id 17 is used.
alias;catid;module-loader
sample-article;2;17
ACF - OpenStreetMap
Create a custom field of type OpenStreetMap using Advanced Custom Fields
The value of this custom field in import is its coordinates. Check the sample content with field name and value combined with #
alias;catid;open-street-map
sample-article;2;"coordinates#17.465367,78.500378"
ACF - PHP
Create a custom field of type PHP using Advanced Custom Fields
In import file write the PHP code to be executed. Make sure the double quotes are escaped when writing the code.
Check the below sample import content with simple PHP script to print a sample text.
alias;catid;php
sample-article;2;"echo 'print my name';"
ACF - PayPal
Create a custom field of type PayPal using Advanced Custom Fields. This custom field takes two required values, PayPal email address and currency. This needs to be set when the custom field is created.
This field takes two values in import. Item name and price of the item, the field and values are combined with # and separated with | with each other.
alias;catid;paypal
sample-article;2;item_name#Nike Shoe|price#10
ACF - Progress Bar
Create a custom field of type Progress Bar using Advanced Custom Fields
In the import content set the percentage to be shown in progress bar. In the sample import content below the progress bar is set to show 80%.
alias;catid;progress-bar
sample-article;2;80
ACF - QR Code
Create a custom field of type QR Code using Advanced Custom Fields
Use the sample content below for import. The import value of the field is text but after import the text will be converted into QR Code for scanning.
alias;catid;qr-code
sample-article;2;testcode
ACF - SoundCloud
Create a custom field of type Soundcloud using Advanced Custom Fields
This custom field takes two values in import, SoundCloud Id and the playlist mode. The field and values are combined with # and separated by |.
alias;catid;soundcloud
sample-article;2;id#341546259|playlist#1
ACF - Telephone
Create a custom field of the type telephone using Advanced Custom Fields
Enter the telephone number in the import file for the custom field
alias;catid;telephone
sample-article;2;+11-234-34
ACF - Timepicker
Create a custom dield of type Time picker using Advanced Custom Fields
In the import file set value of time in the field. Check the sample import content below
alias;catid;time-picker
sample-article;2;15:25
ACF - True/False
In the import file set value 1 or 0 for the field. 1 represents true value and 0 represents 0 value.
See the sample of the import content with true value set for custom field.
alias;catid;true-or-false
sample-article;2;1
ACF - Twitter
Create a custom field of type Twitter using Advanced Custom Fields
In the import content enter the Twitter handle for the custom field value. Check the sample import content below.
alias;catid;twitter
sample-article;2;@testuser
ACF - URL
Create a custom field of type URL using Advanced Custom Fields
In the import content, url needs three values separated by |. The field and the values are joined by #.
text - The text to be linked with URL
url - The url to be linked to the text.
target - If the link should be opened in same tab or new tab or as popup. The supported values are
- same_tab - To open the link on same page
- new_tab - To open the link in new page
- popup - To open page in popup window.
Sample of import content to open link in same page.
alias;catid;url
sample-article;2;text#Google|url#www.google.com|target#same_tab
ACF - Vimeo
Create a custom field of type Vimeo using Advanced Custom Fields
In the import use the vimeo URL for Vimeo custom field. Sample content to import
alias;catid;vimeo
sample-article;2;"https://vimeo.com/240657577"
ACF - WhatsApp Click to Chat
Create a custom field of type WhatsApp Click to Chat using Advanced Custom Fields
In the sample import content use the phone number to be linked with whatsap chat.
alias;catid;whatsap-chat
sample-article;2;9493417611
ACF - Youtube
Create a custom field of type Youtube using Advanced Custom Fields. Use the field name in the import fields.
alias;catid;youtube
sample-article;2;"https://www.youtube.com/watch?v=SpmzPi606zo"