Advanced Custom Fields

After installing ACF from the plugin directory, you should have a Custom Fields option available in the sidebar. Head over there and add a new field group.

Say, for this example we would like to add a location field to the default post. We’ll name the field group to someone appropriate such as ‘Post’.

Now add a new field. In this section you can choose the field type as well as other options.

The Field label is what it will be referred to in the admin panel. Field name is what you’ll refer this field by in the frontend. I recommend having field names in lowercase and with underscores instead of spaces.

Everything else is optional. Default field type is the text field. If you change the field type, there will be more options available to you specific to that field type.

Now we’ll attach this field group to the default post type. To do this, set the field  location filter to ‘Post type’ – ‘is equal to’ – ‘Post’. This should be the default anyways.

Now create a new post(or select an existing one) and there should be a metabox looking like this:

Fill in some text. This will now be available in the frontend.

Now, open the content-single.php template(or whatever template your theme uses for single post type) and paste <?= get_field('location'); ?> in.

This will show the text you’ve entered in the field inside the backend. This is the basis of how custom fields work and in general, how content management systems work in general.

There’s more to this. You can attach the metabox in the admin sidebar(the one on the right), on the page post type, in your custom post type, even on taxonomies(and custom taxonomies too).

There’s also an option to setup a global ‘options’ page where you can setup commonly use fields.

You can also change their look and positioning inside the field group options, disable the default wysiwyg editor and a bunch of other stuff. This truly opens up new ways of developing your WordPress website.

There are over 20 fields available. Some of the most common ones are:

• text
• checkbox
• select
• button group
• file
• gallery
• image
• wysiwyg editor
• date time picker
• google map
• flexible content(very useful)
• Repeater(very very useful)
• Link
• Post Object
• Relationship

with more on the way.

Of all these, the repeater field is super useful as it allows you to nest field groups. Best of all – you can have unlimited nesting. This is a very powerful capability which is hard to find even in modern CMSs.

Also checkout awesomeacf where you can find 3rd party fields.

At its core, the best part of ACF is its simple and elegant api. There are two methods, get_field($name, $id) and the_field($name, $id)

While both are the same, get_field() gets the field while the_field() echoes out the field.

The $id parameter is the $id of the post(or page, taxonomy, user_id, etc) you want to retrieve the field from.

Say you’ve got two fields with the same name(eg: name is location), one is attached to the default post type while other is attached to a page post type. To get the location field of the post type, you’ll set the $id to the post’s id. Put the id of the page post type to get the location of that page. Of course, if you do this inside the loop you don’t need to provide the id as it will get the id off the $post variable.

There’s a lot more you can do with it. Checkout their documentation page for more information.

The documentation is by far, the best I’ve seen for a WordPress plugin – and one of the best for any commercial project(except stripe and airtable)

Everything is neatly organized and the there are heaps of guides available to help you implement specific functionality. You can do some pretty crazy stuff with it, like using the acf fields as a frontend form.

Checkout the guides/tutorial section for more.

At the time of this writing ACF doesn’t support the Wp rest API out of the box. There’s a very solid helper plugin via which you can add rest support.

Unfortunately due to the database structure, you don’t get acf values attached to the post. Instead, you’ll need to query acf fields separately on a different endpoint. Also, relationship fields are not not prepopulated with post data.

You can still overcome these problems but if you’re serious about getting the routes and database structure of your application right, using WordPress is probably the wrong choice.

Mainly I would advise not switching themes made with ACF. After switching themes there is a lot of data lying around inside the meta table and this could create conflicts if new fields are made.

Other than that:

• The devs had changed some stuff in the past breaking backward compatibility.  ACF has been pretty stable since then but you may want to check for compatibility issues before updating(Even now there are still some discrepancies in features between versions so make sure to always keep the version of ACF on the server and local the same)
• By default, ACF stores field details in the database. You can use acf-json(I highly recommend using this) to store them as json files inside your theme folder. So if you move your theme in an empty wp installation, your fields will still be there.
• ACF specific functions like get_field(), the_field() etc. will break your website if you remove the plugin. So you need to have it installed.

ACF supports the new Gutenberg update. Period.

Basically you don’t need to do anything new as a developer. All the fields will just show up below the Gutenberg editor from now on. Also, both the free and the paid versions are compatible.

This support was added in the 5.7 update so if you haven’t updated ACF in a long time, this would be a good time to do so.

If you’re having trouble implementing fields, your best bet would be to consult the documentation. If you still hit a roadblock, make a post in the forums – they are pretty active and the developers frequent the forums too.

If you’re still stuck, open a support ticket.

ACF is a completely free plugin – however most of the useful fields come bundled in the ACF Pro version.

ACF Pro retails for $25(Single site license) or $100(unlimited site license) with lifetime updates for both.

Once you’ve installed the pro plugin, add in your license key in Sidebar > Custom Fields > Updates to enable updates.

Previously the premium fields were available separately. As of ACF version 5, they are only available through the ACF Pro version.

We highly recommend getting the pro version as it contains important fields like the repeater and the flexible content field as well as the fact that it comes with lifetime updates.

With heaps of field types available, massive community support behind it and continuous updates, ACF is a must if you want to build a custom WordPress website nowadays.

Unlike other custom field plugins/CMSs, it has an intutive drag-and-drop builder to create field groups. This may not sit well with devs who like to create field groups programmatically(ACF can do that too) but in my experience, it is much more faster to just create field groups with the given UI.

Just beware of the gotchas during migration and development.

Note that ACF is not a replacement against content builder plugins. They are client oriented and come with their own styles and content blocks.