Field Connections
Field connections enable you to seamlessly retrieve data from your website's WordPress database and effortlessly integrate it into designated row, column, and module options, presenting the data beautifully within your Beaver Themer layouts.
The versatility of these connections allows data extraction from a multitude of sources, including WordPress data, WordPress custom fields, and popular plugins like Advanced Custom Fields, Big Commerce, Easy Digital Downloads, The Events Calendar, and WooCommerce.
Furthermore, field connections extend their support to shortcodes, granting you the flexibility to apply them not only within row, column, or module options but also throughout your entire layout wherever text can be inserted. This includes HTML modules or the custom layout option for the Post module.
Note: The above diagram showcases WordPress, Advanced Custom Fields and WooCommerce as data sources, but field connections can also be used with other supported plugin, such as BigCommerce, Easy Digital Downloads, and The Events Calendar.
Why use Field Connections?
Field Connections allow you to streamline your workflow by eliminating the need to create separate layouts for individual posts or pages. Instead, you can create one singular layout, assign this to all posts on your website and use field connections to dynamically display the correct data for each post or page.
Data Sources & Natively Supported Plugins
Field Connections natively support the following data sources and plugins.
- WordPress Data
- WordPress Custom Fields
- Advanced Custom Fields
- BigCommerce
- Easy Digital Downloads
- The Events Calendar
- WooCommerce
Toolset custom fields are fully compatible and function in a manner similar to WordPress custom fields. However, to utilize Toolset custom fields effectively, it is necessary to prefix your field's name (key) with wpcf-
.
Additionally, third-party plugins like Pods, and Meta Box have integrated their own field connections, ensuring smooth compatibility with Beaver Themer.
Data Types
When applying field connections to options, ensuring the data type aligns with the intended option is crucial. This ensures that the option you are connecting can accurately output the data.
For example, when using a field connection that outputs an image, like the Featured Image field connection, it should be applied to an option that can display images, such as the option found in the Photo module. If you attempt to apply the Featured Image field connection to a text option, like those present in the Header and Text modules, the connection can still be made. But, you will only be able to output details about the image, such as URL, Title, Caption, Description, or Alt Text, as these details can be presented as text.
Theme Data
Due to variations in how each theme manages customizer settings, it is not possible to utilize field connections for outputting theme data from the WordPress Customizer settings.
An alternative is to utilize the Advanced Custom Fields (ACF) Options Page feature, which allows you to create an additional admin page in your WordPress Dashboard. Any fields you include on the Options Page become global, meaning the data can be accessed and used throughout your entire website.
See the ACF Options Page article for more information.
WordPress Multisite Support
Field Connection are supported in WordPress Multisite Network installations. However, it is important to be aware that these field connections cannot be used to retrieve data between sub-sites.
For instance, if you have a WordPress Multisite network with three sub-sites - Site A, Site B, and Site C - using field connections, you cannot retrieve data from Site A and display it on Site B or Site C. The data retrieval is limited to within each individual sub-site and cannot be extended across the network.
In this Section
📄️ Getting Started
This article serves as a comprehensive guide to help you get started with field connections. We will walk you through the process of adding, editing, and deleting field connections, as well as explain the distinctions between "connect" and "insert" functions and field connection limitations.
📄️ Shortcode Syntax
The Field Connection shortcode offers a straightforward way to showcase data from custom fields in your layouts. This reference illustrates the syntax for the field connection shortcode.
📄️ Conditionals
The Field Connections shortcode syntax supports conditionals, allowing you to display dynamic content based on the evaluation of statements as TRUE or FALSE. This functionality is available for all Beaver Themer field connection shortcodes, including Advanced Custom Fields (ACF), BigCommerce, Easy Digital Downloads, The Events Calendar, and WooCommerce.
📄️ Expressions
Expressions enhance the capabilities of conditional field connection shortcodes, allowing you to showcase content depending on the value retrieved from the field. For instance, you can create an expression where if the field's value is less than 2, it will display the text "This field has a value less than 2". If the value is greater than 2, it will show the text "This field has a value greater than 2".
📄️ WordPress Data
In this article, you'll find a comprehensive list of available WordPress data field connection shortcodes. These shortcodes enable you to retrieve various types of data, including the title of your page or post, page or post content, publishing date, archive title, and more.
📄️ WordPress Custom Fields
WordPress Custom Fields is a feature in WordPress which allows you to add additional information to your pages, posts, and custom post types. You do this by adding a key which is the custom field name and a value which is the information you want to display on your page or post. You can then use Beaver Themer field connections to display this data into your layout.
📄️ Third-party
This article gives a brief introduction to using field connections with fields created in third-party plugins that are not inherently supported by Beaver Themer.
🗃️ Shortcode Examples
3 items