The Vimeo Field

The "Vimeo" custom field gives you the ability to display a Vimeo video at your frontend just by filling out the URL or just the ID of the Vimeo video.

Field Settings

The "Vimeo" custom field provides you all of the customization options of the player which will display the video at your frontend.

acf-vimeo-customization-options

As you can see from the screenshot above, after choosing the correct Type, you can customize your player however you'd like. The customization options are all of the options that Vimeo provides for embedding videos into your website.

Let's see what each option does.

Name Description
Name The name will be used to identify the field. Leave this blank and Joomla will fill in a default value from the title.
Label The label of the field to display.
Description A description of the field that will be displayed in the label tooltip.
Required Is this a mandatory field?
Video Width If you prefer to use percentage you have to type the percentage sign '%' at the end of your value like so, 90%.
Video Height The video's height in pixels. You can also use a percentage here the same way as you do with the width.
Autoplay Choose if you want the video to start playing when the page finishes loading.
Loop Choose if you want the video to start playing from the beginning once it finishes.
Display Title Choose if you want to display the video's title inside the player.
Display Byline Choose if you want to display the byline inside the player. The byline is the informative text under the title which in most occassions is the creator's username.
Display Portrait Choose if you want to display the creator's portrait.
UI Color Choose the player's UI color. This color will be used for the title, the byline and the player's controls.

Usage

Once you are in your Article's Edit screen, choose the "Fields" Tab to see the Vimeo custom field as you can see in the screenshot below.

acf-vimeo-usage

In this textbox you can type in the full URL or just the ID of the Vimeo video that you are interested in.

Frontend Display

Take a look at the screenshot below to see how it could be displayed in your frontend.

acf-vimeo-frontend