acf_form（）

如何你看完本文还不知道如何使用该函数，可以联系我定制视频教程，50元/个函数，学不会全额退款

描述

显示用于添加或编辑帖子的表单。有许多可用于自定义表单的设置，这些设置是通过添加到$options数组来设置的，如下所述。

您也可以使用acf_register_form（）函数注册表单。

参量

<?php acf_form( $settings ); ?> 

$设置

（字符串|数组）注册表单的设置或“ id”的数组。

• id
  （字符串）表单的唯一标识符。默认为'acf-form'。'id' => 'acf-form',
• post_id
  （整数|字符串）用于确定要显示的字段，加载数据的位置和保存数据的位置的发布ID。默认为当前帖子ID。也可以发送到“ new_post”以在提交时创建新帖子。'post_id' => false,
• new_post
  （数组）当上述属性设置为“ new_post”时，此设置用于创建帖子。有关可用参数，请参见wp_insert_post。'new_post' => false,
• field_groups
  （Array）字段组ID /键的数组，以覆盖此表单中显示的字段。'field_groups' => false,
• 字段
  （数组）字段ID /键的数组，用于覆盖此表单中显示的字段。'fields' => false,
• post_title
  （布尔值）是否显示帖子标题文本字段。默认为false。'post_title' => false,
• post_content
  （布尔值）是否显示帖子内容编辑器字段。默认为false。'post_content' => false,
• form
  （布尔值）是否创建form元素。添加到现有表单时很有用。默认为true。'form' => true,
• form_attributes
  （Array）表单元素的数组或HTML属性。'form_attributes' => array(),
• return
  （String）提交表单后要重定向到的URL。默认为带有GET参数'？updated = true'的当前URL。
  特殊的占位符'％post_url％'将转换为帖子的永久链接。
  特殊的占位符'％post_id％'将转换为帖子的ID。'return' => '',
• html_before_fields
  （String）在字段之前添加的额外HTML。'html_before_fields' => '',
• html_after_fields
  （String）在字段之后添加的额外HTML。'html_after_fields' => '',
• Submit_value
  （字符串）显示在提交按钮上的文本。'submit_value' => __("Update", 'acf'),
• Updated_message
  （字符串）重定向后在窗体上方显示的消息。也可以设置为false，不发送任何消息。'updated_message' => __("Post updated", 'acf'),
• label_placement
  （字符串）确定字段标签相对于字段的位置。默认为“ top”。选择“顶部”（上方字段）或“左侧”（旁边字段）。'label_placement' => 'top',
• struction_placement
  （字符串）确定相对于字段放置字段指令的位置。默认为“标签”。选择“标签”（在标签下方）或“字段”（在字段下方）。'instruction_placement' => 'label',
• field_el
  （String）确定用于包装字段的元素。默认为'div'。可以选择“ div”，“ tr”，“ td”，“ ul”，“ ol”，“ dl”。'field_el' => 'div',
• uploader
  （字符串）是使用WP上传器还是用于图像和文件字段的基本输入。默认为'wp'。“ wp”或“ basic”的选择。'uploader' => 'wp',
• honeypot
  （布尔值）是否包括隐藏的输入字段以捕获非人为形式的提交。默认为true。'honeypot' => true,
• html_updated_message
  （字符串）用于呈现更新的消息的HTML。'html_updated_message' => '<div id="message" class="updated"><p>%s</p></div>',
• html_submit_button
  （字符串）用于呈现提交按钮的HTML。'html_submit_button' => '<input type="submit" class="acf-button button button-primary button-large" value="%s" />',
• html_submit_spinner
  （字符串）用于呈现提交按钮加载微调器的HTML。'html_submit_spinner' => '<span class="acf-spinner"></span>',
• kses
  （布尔值）是否$_POST使用wp_kses_post()函数清除所有数据。默认为true。'kses' => true

变更日志

• kses 在版本5.6.5中添加。
• uploader 在版本5.2.4中添加。
• honeypot 在版本5.3.4中添加
• html_updated_message，，html_submit_button并html_submit_spinner在5.5.10版中添加

例子

编辑当前帖子

本示例演示了如何显示基本表单来编辑当前帖子。

page-basic-form.php

<?php acf_form_head(); ?>
<?php get_header(); ?>

<div id="primary" class="content-area">
    <div id="content" class="site-content" role="main">
        <?php while ( have_posts() ) : the_post(); ?>
            <?php acf_form(); ?>
        <?php endwhile; ?>
    </div><!-- #content -->
</div><!-- #primary -->

<?php get_sidebar(); ?>
<?php get_footer(); ?> 

编辑特定帖子

本示例演示了如何显示用于编辑特定帖子的met​​a字段的表单。

页面特定的form.php

<?php acf_form_head(); ?>
<?php get_header(); ?>

<div id="primary" class="content-area">
    <div id="content" class="site-content" role="main">
    <?php while ( have_posts() ) : the_post(); ?>
    <?php acf_form(array(
        'post_id'       => 123,
        'post_title'    => false,
        'post_content'  => false,
        'submit_value'  => __('Update meta')
    )); ?>
    <?php endwhile; ?>
    </div><!-- #content -->
</div><!-- #primary -->

<?php get_sidebar(); ?>
<?php get_footer(); ?> 

创建特定帖子

本示例演示了提交表单时如何创建新帖子。

page-new-form.php

<?php acf_form_head(); ?>
<?php get_header(); ?>

<div id="primary" class="content-area">
    <div id="content" class="site-content" role="main">
    <?php while ( have_posts() ) : the_post(); ?>
    <?php acf_form(array(
        'post_id'       => 'new_post',
        'new_post'      => array(
            'post_type'     => 'event',
            'post_status'   => 'publish'
        ),
        'submit_value'  => 'Create new event'
    )); ?>
    <?php endwhile; ?>
    </div><!-- #content -->
</div><!-- #primary -->

<?php get_sidebar(); ?>
<?php get_footer(); ?> 

笔记

在AJAX模式中显示

在AJAX模式（或任何其他动态附加的方法）中显示ACF表单时，请注意，该页面将需要一些额外的PHP和JavaScript代码。

• PHP
  必须在<body>标记内以及“ wp_footer”操作之前运行以下功能。这将创建一个隐藏的WYSIWYG字段，并将所需的JS模板排入WP媒体弹出窗口。// Enqueue uploadedr scripts.acf_enqueue_uploader();
• JS
  在完成AJAX请求并将新的HTML（包含ACF表单）添加到DOM之后，必须运行以下JS。这将允许ACF初始化新添加的HTML中的字段。// Trigger the append action and provide the newly appended jQuery element.acf.do_action('append', $('#popup-id'));

acf_form_head（）

重要的是要注意，尽管该acf_form()函数将显示一个表单，但在提交时将不处理该表单。该任务由另一个名为的函数处理acf_form_head()。为了允许表单保存数据，您需要acf_form_head()在呈现任何HTML之前将函数放在页面模板的顶部。

安全

从5.6.5版开始，ACF使用wp_kses_post（）函数清理内容并清除恶意脚本。如果需要，可以通过将表单kses设置更改为false 来禁用此清理功能。