Displaying custom field data in Wordpress - Step-by-Step Execution

Concept Flow - Displaying custom field data

Start: WordPress loads post

↓

Check if custom field exists

↓

Get custom field

↓

Display custom field value

↓

End

WordPress loads a post, checks for a custom field, retrieves it if present, and displays its value.

Execution Sample

Wordpress

<?php
$value = get_post_meta($post->ID, 'my_custom_field', true);
if ($value) {
  echo $value;
}
?>

This code gets a custom field named 'my_custom_field' from the current post and displays it if it exists.

Execution Table

Step	Action	Evaluation	Result
1	Call get_post_meta with post ID and 'my_custom_field'	Returns value or empty string	'Special offer'
2	Check if $value is truthy	$value = 'Special offer'	True
3	Execute echo $value	Outputs 'Special offer'	Displays 'Special offer' on page
4	End script	No more code	Finished displaying custom field

💡 Custom field value found and displayed; script ends.

Variable Tracker

Variable	Start	After Step 1	After Step 2	Final
$value	undefined	'Special offer'	'Special offer'	'Special offer'

Key Moments - 2 Insights

Why do we check if $value is truthy before echoing?

Because get_post_meta returns an empty string if the custom field doesn't exist, checking avoids showing empty output. See execution_table step 2.

What does the third parameter 'true' in get_post_meta do?

It makes get_post_meta return a single value as a string instead of an array. This is why $value holds the direct custom field value. See execution_table step 1.

Visual Quiz - 3 Questions

Look at the execution table, what is the value of $value after step 1?

A 'Special offer'

B Empty string

C Null

D Array

💡 Hint

Check the 'Result' column in execution_table row 1.

At which step does the script decide not to display anything if the custom field is missing?

A Step 1

B Step 3

C Step 2

D Step 4

💡 Hint

Look at the condition check in execution_table step 2.

If the third parameter in get_post_meta was false, what would $value be?

A A string with the custom field value

B An array containing the custom field value

C Null

D Boolean false

💡 Hint

Recall that 'true' returns a single value, 'false' returns an array.

Concept Snapshot

Use get_post_meta(postID, 'field_name', true) to get a single custom field value.
Check if the value exists before displaying.
If true is false, you get an array instead.
Echo the value to show it on the page.
This is how WordPress displays custom field data safely.

Full Transcript

When WordPress loads a post, you can get custom field data using get_post_meta with the post ID and the custom field name. The third parameter true makes it return a single value as a string. You check if this value exists to avoid showing empty content. If it exists, you echo it to display on the page. This simple flow ensures custom fields show only when they have data.

Practice

1. What is the main function used in WordPress to retrieve custom field data for a post?

easy

A. get_post_meta()

B. get_custom_field()

C. fetch_post_data()

D. retrieve_meta()

Solution

1. Step 1: Identify the WordPress function for custom fields

   The standard WordPress function to get custom field data is get_post_meta().

2. Step 2: Confirm other options are not standard functions

   Functions like get_custom_field(), fetch_post_data(), and retrieve_meta() do not exist in WordPress core.

3. Final Answer:

   get_post_meta() -> Option A

4. Quick Check:

   Custom field retrieval = get_post_meta() [OK]

Hint: Remember: WordPress uses get_post_meta() for custom fields [OK]

Common Mistakes:

• Confusing function names with non-existent ones
• Using get_post_meta() without parameters
• Trying to access custom fields like normal variables

2. Which of the following is the correct syntax to get a single custom field value with key 'color' for post ID 42?

easy

A. get_post_meta(42, 'color', true);

B. get_post_meta('color', 42, true);

C. get_post_meta(42, 'color');

D. get_post_meta('color', 42);

Solution

1. Step 1: Understand get_post_meta() parameters order

   The function signature is get_post_meta($post_id, $key, $single). So the post ID comes first, then the key, then whether to return a single value.

2. Step 2: Check which option matches this order

   get_post_meta(42, 'color', true); uses get_post_meta(42, 'color', true); which is correct. Others swap parameters or miss the third argument.

3. Final Answer:

   get_post_meta(42, 'color', true); -> Option A

4. Quick Check:

   Correct parameter order = post ID, key, single [OK]

Hint: Post ID is first, key second, true for single value [OK]

Common Mistakes:

• Swapping post ID and key parameters
• Omitting the third parameter for single value
• Passing key as first argument

3. Given the code snippet:

$value = get_post_meta(10, 'price', true);
echo $value;

What will be the output if the custom field 'price' for post ID 10 is set to '25.99'?

medium

A. Error: Undefined variable

B. Array

C. NULL

D. 25.99

Solution

1. Step 1: Understand get_post_meta() with single=true

   When the third parameter is true, get_post_meta() returns a single value as a string, not an array.

2. Step 2: Check the stored value for 'price'

   The custom field 'price' for post ID 10 is '25.99', so echoing $value outputs '25.99'.

3. Final Answer:

   25.99 -> Option D

4. Quick Check:

   Single meta value output = 25.99 [OK]

Hint: Use true to get single value, not array [OK]

Common Mistakes:

• Expecting an array instead of a string
• Not setting the third parameter to true
• Assuming NULL if value exists

4. Identify the error in this code snippet:

echo get_post_meta('price', 15, true);

medium

A. Function get_post_meta() does not exist

B. Missing third parameter

C. Parameters are in wrong order

D. Post ID must be a string

Solution

1. Step 1: Check parameter order in get_post_meta()

   The correct order is get_post_meta($post_id, $key, $single). Here, 'price' (key) is first and 15 (post ID) second, which is wrong.

2. Step 2: Confirm other options are incorrect

   The third parameter is present, the function exists, and post ID should be an integer, not string.

3. Final Answer:

   Parameters are in wrong order -> Option C

4. Quick Check:

   Post ID first, key second in get_post_meta() [OK]

Hint: Post ID always comes before key in get_post_meta() [OK]

Common Mistakes:

• Swapping post ID and key parameters
• Assuming post ID can be string
• Omitting required parameters

5. You want to display a custom field 'rating' for the current post inside the Loop, but only if it exists and is not empty. Which code snippet correctly does this?

hard

A. echo get_post_meta('rating', get_the_ID(), true);

B. if ($rating = get_post_meta(get_the_ID(), 'rating', true)) { echo esc_html($rating); }

C. if (get_post_meta('rating')) { echo get_post_meta(get_the_ID(), 'rating'); }

D. echo get_post_meta(get_the_ID(), 'rating');

Solution

1. Step 1: Retrieve 'rating' for current post with correct parameters

   Use get_post_meta(get_the_ID(), 'rating', true) to get a single value for the current post inside the Loop.

2. Step 2: Check if value exists and sanitize before output

   Assign the value to a variable and check if it is truthy (not empty). Use esc_html() to safely display it.

3. Step 3: Evaluate options

   if ($rating = get_post_meta(get_the_ID(), 'rating', true)) { echo esc_html($rating); } correctly does all steps. echo get_post_meta('rating', get_the_ID(), true); swaps parameters. if (get_post_meta('rating')) { echo get_post_meta(get_the_ID(), 'rating'); } uses wrong parameter order and no sanitization. echo get_post_meta(get_the_ID(), 'rating'); echoes without checking if value exists.

4. Final Answer:

   if ($rating = get_post_meta(get_the_ID(), 'rating', true)) { echo esc_html($rating); } -> Option B

5. Quick Check:

   Check existence + sanitize output = if ($rating = get_post_meta(get_the_ID(), 'rating', true)) { echo esc_html($rating); } [OK]

Hint: Assign and check value before echoing, sanitize output [OK]

Common Mistakes:

• Swapping post ID and key parameters
• Not checking if value exists before echo
• Not sanitizing output before display