Creating Custom Fields and Content Types in WordPress with ACF

WordPress is a highly flexible content management system, but its default “Post” and “Page” structures are often not enough for specialized websites. To transform WordPress into a true database-driven platform, developers use Advanced Custom Fields (ACF). This allows you to store specific data-like a book’s ISBN, a car’s mileage, or a project’s completion date-in a structured way.

Context

When you use ACF, you move away from trying to fit all your information into the standard WordPress text editor. Instead, you create a “Group” of specific inputs (fields) that only appear when you are editing a certain type of content. This keeps the administration panel clean and ensures data consistency across your site.

Installing and Configuring the ACF Plugin

The plugin acts as a visual interface for the WordPress Metadata API, allowing you to create complex data structures without writing SQL queries.

1. Plugin Installation

1. Log in to your WordPress admin panel.
2. Navigate to Plugins > Add New.
3. Search for Advanced Custom Fields.
4. Click Install Now and then Activate.

2. Creating Custom Field Groups

A “Field Group” is a collection of fields that share the same display rules.

1. Go to the ACF (or Custom Fields) tab in your sidebar.
2. Click Add New Group and give it a descriptive name, such as “Real Estate Details.”
3. Add Fields: Click the + Add Field button.
   • Field Label: What the user sees (e.g., “Price”).
   • Field Name: What the code uses (e.g., property_price).
   • Field Type: Choose from text, images, date pickers, or even relationship links.
4. Location Rules: Define where these fields should appear. For example: “Show this field group if Post Type is equal to Property.”

Creating Custom Post Types (CPT)

While ACF manages the data fields, a Custom Post Type defines the content container. For example, if you are building a movie database, “Movies” would be your CPT, and “Director” would be an ACF field.

Adding CPT via Code

You can register a new content type by adding a function to your theme’s functions.php file:

PHP

function register_my_cpts() {
    $args = array(
        'public' => true,
        'label'  => 'Portfolio',
        'supports' => array('title', 'editor', 'thumbnail'),
        'menu_icon' => 'dashicons-portfolio',
        'has_archive' => true,
    );
    register_post_type('portfolio', $args);
}
add_action('init', 'register_my_cpts');

Note: Modern versions of ACF (Pro and some free versions) now allow you to create Custom Post Types directly within the ACF user interface, removing the need for manual code.

Displaying Custom Fields in Your Theme

Unlike standard post content, ACF data does not appear automatically. You must tell your WordPress theme exactly where to display it by editing your template files (like single.php or archive.php).

Basic Text Display

To display a simple text field, use the get_field() function:

PHP

<?php
$price = get_field('property_price');
if ($price) {
    echo '<div class="price">Price: ' . esc_html($price) . '</div>';
}
?>

Displaying an Image

When using an Image field, it is best to set the “Return Format” to Image ID in the ACF settings for the best performance.

PHP

<?php
$image_id = get_field('project_gallery_image');
if ($image_id) {
    echo wp_get_attachment_image($image_id, 'large');
}
?>

Benefits of the ACF Workflow

• User-Friendly Data Entry: Clients or editors see specific boxes for specific information, preventing them from breaking the site’s layout.
• Data Integrity: By choosing field types like “Date Picker” or “Number,” you ensure the data is always saved in the correct format.
• Development Speed: You can build complex, bespoke layouts (like “Team” pages or “Product Specs”) much faster than coding custom meta boxes from scratch.

Practical Implications

• Performance: While ACF is efficient, loading dozens of fields on a single page can increase database queries. Use a caching plugin on your mybox-hosted site to keep response times fast.
• ACF Pro: For advanced features like Repeater Fields (which let you add an unlimited list of items, like ingredients) or Flexible Content, you may need the Pro version of the plugin.
• Search: By default, standard WordPress search does not look inside ACF fields. If you need this functionality, you may need an additional plugin like SearchWP or Relevanssi.

Summary

Advanced Custom Fields transforms WordPress from a simple blogging tool into a professional-grade engine for complex data. By combining Custom Post Types with tailored ACF fields and simple PHP functions, you can display exactly the information your audience needs in a structured, beautiful layout.