Original CFS-compatible
API reference

Retrieves a stored value by field name. Pass a post ID as the second argument to retrieve from another post. Omit the field name to retrieve the CFS field values for the post as an array.

<?php
echo esc_html( CFS()->get( 'field_name' ) );

echo esc_html( CFS()->get( 'field_name', 123 ) );

$fields = CFS()->get();
?>

Retrieval and output are separate steps. Escape for the output context with functions such as esc_html(), esc_url(), and wp_kses_post().

The third argument can specify the value format. For normal theme output, use the default api format.

<?php
$value = CFS()->get( 'field_name', get_the_ID(), array(
  'format' => 'raw',
) );
?>

raw is useful when you need the unformatted stored value. For most templates, api is easier to work with.

Returns post IDs that reference a given post through a relationship field.

<?php
$post_ids = CFS()->get_reverse_related( get_the_ID(), array(
  'field_name'  => 'related_posts',
  'post_type'   => 'post',
  'post_status' => 'publish',
) );

foreach ( $post_ids as $post_id ) {
  echo esc_html( get_the_title( $post_id ) );
}
?>

atshift Fields hardens the reverse relationship query by sanitizing input values and preparing SQL clauses.

Saves CFS field values. Pass an ID to update an existing post, or provide post data such as post_type and post_status to create a new post.

<?php
$post_id = CFS()->save(
  array(
    'field_name' => 'Value to save',
  ),
  array(
    'ID' => get_the_ID(),
  )
);
?>

Create a new post and save fields

<?php
$post_id = CFS()->save(
  array(
    'field_name' => 'Value to save',
  ),
  array(
    'post_type'   => 'post',
    'post_status' => 'draft',
    'post_title'  => 'Draft title',
  )
);
?>

When saving from the front end, always combine this with a nonce, authentication, current_user_can() capability checks, and input validation.

Renders a field group as a front-end form. atshift Fields keeps the compatible API while adding stronger server-side validation, submitted-value preservation, and inline error display.

<?php
echo CFS()->form( array(
  'post_id'          => false,
  'field_groups'     => array( 123 ),
  'post_type'        => 'post',
  'post_status'      => 'draft',
  'submit_label'     => 'Save',
  'confirmation_url' => home_url( '/thanks/' ),
) );
?>

See the implementation examples for creating new posts and editing existing posts.

• Main API methods called through CFS().
• Existing field groups, post metadata, and theme output using CFS()->get().
• Core data structures for loops, relationships, and field metadata.

• Fields that depended on original CFS Add-ons.
• Fields added by atshift Fields if you later return to the original plugin.
• Escaping for fields that contain HTML.
• Capabilities and validation when saving from the front end.