WordPress主题开发，从入门到精通。

4. 去除头部无用代码

function initialize(){

    /*
     * 去除头部多余无用的东西
     * */
    remove_action('wp_enqueue_scripts', 'wp_enqueue_global_styles'); // 内联样式
    remove_action('wp_footer', 'wp_enqueue_global_styles', 1);//dobate 图标
    remove_action('wp_head', 'wp_generator'); // 移除 WordPress 版本
    remove_action('wp_head', 'rsd_link'); // 移除离线编辑器开放接口
    remove_action('wp_head', 'wlwmanifest_link'); // 移除离线编辑器开放接口
    remove_action('wp_head', 'index_rel_link'); // 去除本页唯一链接信息
    remove_action('wp_head', 'parent_post_rel_link', 10, 0); // 清除前后文信息
    remove_action('wp_head', 'start_post_rel_link', 10, 0); // 清除前后文信息
    remove_action('wp_head', 'adjacent_posts_rel_link_wp_head', 10, 0); // 清除前后文信息
    remove_action('wp_head', 'feed_links', 2); // 移除 feed
    remove_action('wp_head', 'feed_links_extra', 3); // 移除 feed
    remove_action('wp_head', 'rest_output_link_wp_head', 10); // 移除 wp-json 链
    remove_action('wp_head', 'print_emoji_detection_script', 7); // 头部的 JS 代码
    //remove_action('wp_head', 'wp_print_styles', 8); //emoji 载入 css
    remove_action('wp_head', 'rel_canonical'); //rel=canonical
    remove_action('wp_head', 'wp_shortlink_wp_head', 10, 0); //rel=shortlink

    /* 移除 emjoy*/
    remove_action('wp_head', 'print_emoji_detection_script', 7);
    remove_action('admin_print_scripts', 'print_emoji_detection_script');
    remove_action('wp_print_styles', 'print_emoji_styles');
    remove_action('admin_print_styles', 'print_emoji_styles');
    remove_filter('the_content_feed', 'wp_staticize_emoji');
    remove_filter('comment_text_rss', 'wp_staticize_emoji');
    remove_filter('wp_mail', 'wp_staticize_emoji_for_email');

    /* 移除文章内的 embed 内容 */
    remove_action('wp_head', 'wp_oembed_add_discovery_links');
    remove_action('wp_head', 'wp_oembed_add_host_js');


    add_filter('wp_resource_hints', // 移除 WordPress 头部加载 DNS 预获取（dns-prefetch）function ($hints, $relation_type) {if ('dns-prefetch' === $relation_type) {return array_diff(wp_dependencies_unique_hosts(), $hints);
            }

            return $hints;
        }, 10, 2); // 头部加载 DNS 预获取（dns-prefetch）}
add_action('after_setup_theme', 'initialize'); // 去除博客无用代码

5. 禁用区块编辑器

// 禁止 Gutenberg 编辑器
add_filter('use_block_editor_for_post', '__return_false');
remove_action('wp_enqueue_scripts', 'wp_common_block_scripts_and_styles');

6. 切换经典小工具编辑器

// 禁止新版小工具
add_filter('gutenberg_use_widgets_block_editor', '__return_false');
add_filter('use_widgets_block_editor', '__return_false');

7. 添加后台编辑器按钮

editor.addButton('PureHighlightjsInsert', {
	title : PureHighlightjsTrans.title,
	icon: 'wp_code',
	onclick: function() {
		editor.windowManager.open({
			title : PureHighlightjsTrans.title,
			minWidth : 700,
			body : [
				{
					type : 'listbox',
					name : 'lang',
					label : PureHighlightjsTrans.language,
					values : languageValues
				},
				{
					type : 'textbox',
					name : 'code',
					label : PureHighlightjsTrans.code,
					multiline : true,
					minHeight : 200
				}
			],
			onsubmit : function(e){var code = e.data.code.replace(/rn/gmi, 'n'),
					tag = 'code';

				code =  tinymce.html.Entities.encodeAllRaw(code);

				var sp = (e.data.addspaces ? '' :'');

				editor.insertContent(sp + '
' + code + 'n
'+ sp +'
');

			}

		});

	}

});

8. 注册插件
tinymce.create('tinymce.plugins.info', {init : function(ed, url) {
		ed.addButton('info', {
			title : '蓝色背景栏',
			image : url+'/images/info.png',
			onclick : function() {ed.selection.setContent('[info]' + ed.selection.getContent() + '[/info]');
			}
		});
	},
	createControl : function(n, cm) {return null;},
});
tinymce.PluginManager.add('info', tinymce.plugins.info);

9.wp 版本比较
if (version_compare( $GLOBALS['wp_version'], '5.3', '<') ) {}	

10. 去除后台底部版权和文字提示
function remove_footer($text) {
    $text = '';
    return $text;
}

/*
 * 删除 WordPress 后台底部版权信息、版本号
 * */
add_filter('update_footer', 'remove_footer', 11);
add_filter('admin_footer_text', 'remove_footer', 11);

11. 更换 Gavatar 镜像
/*
 * 替换 Gravatar 头像镜像站地址
 * */
function replace_https_avatar($avatar) {$Image = get_option( 'document_Gravatar');
    //~ 替换为 https 的域名
    $avatar = str_replace( array(
        'secure.gravatar.com/avatar',
        "www.gravatar.com/avatar",
        "0.gravatar.com/avatar",
        "1.gravatar.com/avatar",
        "2.gravatar.com/avatar"
    ), $Image, $avatar );
    //~ 替换为 https 协议
    $avatar = str_replace("http://", "https://", $avatar);

    return $avatar;
}

/*
 * 替换 Gravatar 镜像站地址
 * */
add_filter('get_avatar', 'replace_https_avatar');
add_filter('get_avatar_url', 'replace_https_avatar');

12. 修改文章摘要字数
/*
 * 修改文字摘要字数
 * */
function article_excerpt_lengths($length) {return 300;}

/* 修改文章摘要的数量 */
add_filter('excerpt_length', 'article_excerpt_lengths', 999);

13. 添加页面模板
/*
 * 添加后台可选的页面模板
 * */
function add_page_template($page_templates) {$page_templates['template/page/posts.php']='文章聚合';
    return $page_templates;
}
add_filter('theme_page_templates', 'add_page_template');
add_filter('theme_post_templates', 'add_page_template');

14. 修改页面的固定链接
/*
 * 修改页面的固定链接
 * */
add_action('init', 'custom_page_rules');
function custom_page_rules() {
    global $wp_rewrite;
    $wp_rewrite->page_structure = $wp_rewrite->root . '%pagename%.html';
}

15. 输出文章分页
官方文档：https://developer.wordpress.org/reference/functions/get_the_posts_pagination/
 false,
	'current'            => max(1, get_query_var( 'paged') ),  // 当前页码
	'type'               => 'list'
) );
/* 去除多余的元素 */
$pagination=preg_replace('/^[sS]*?([sS]*)[sS]*?$/', "$1", $pagination );

16. 输出评论分页
1){?>
        

             false]); ?>
        


17. 用户是否登录

18. 博客功能设置

模板循环 
1. 基本用法


注册主题菜单

register_nav_menu()，注册单个自定义的主题页面菜单
register_nav_menus()，注册多个自定义的主题页面菜单
unregister_nav_menu()，删除菜单注册
wp_nav_menu($args)；给定一个 theme_location 参数，该函数显示分配给该位置的菜单。如果不存在这样的位置或没有为其分配菜单，则参数 fallback_cb 将确定显示的内容。如果没有给定 theme_location 参数，函数显示与 menu 参数给出的 ID、slug 或名称匹配的菜单；否则，第一个非空菜单；否则（或者如果 menu 给定的菜单为空），则输出 fallback_cb 参数给定的函数（默认为 wp_page_menu()）；否则什么都没有。
has_nav_menu()，判断某个注册的菜单是否已经被分配菜单

wp_nav_menu 默认参数
 '','container'=>'div','container_class'=>'',
	'container_id'         => '','container_aria_label'=>'',
	'menu_class'           => 'menu',
	'menu_id'              => '','echo'=> true,'fallback_cb'=>'wp_page_menu','before'=>'',
	'after'                => '','link_before'=>'',
	'link_after'           => '','items_wrap'=>'
%3$s
','item_spacing'=>'preserve','depth'=> 0,'walker'=>'',
	'theme_location'       => '',
);

后台添加菜单、主题设置
1. 添加菜单和页面

add_menu_page($page_title , $menu_title , $capability ,  $menu_slug , $callback ', $icon_url' , $position)，$menu_slug 为分节注册可用的 page 参数；$capability，代表用户需要什么权限才会显示这个菜单；
add_menu_page、remove_menu_page，注册、删除一个顶级菜单已经相对应的页面；
add_submenu_page、remove_submenu_page，注册、删除一个子菜单
add_dashboard_page() –index.php、add_posts_page() –edit.php、add_media_page() –upload.php、add_pages_page() –edit.php?post_type=page、add_comments_page() –edit-comments.php、add_theme_page() –themes.php、add_plugins_page() –plugins.php、add_users_page() –users.php、add_management_page() –tools.php、add_options_page() –options-general.php、add_options_page() –settings.php、add_links_page() – link-manager.php– WP 3.5 以后，需要一个插件才能使用。


上面这些函数都有一个必须的参数 capability。这意味着登录到后台的用户需要有相应的职能才能够看到这里添加的菜单选项。如果你的主题或者插件有一个选项页，合理的 控制对该页的访问时非常重要的。例如，如果有一个主题选项页，你需要使用 edit_themes 这个职能（capability)，如果是一个插件选项页，就需要使用 edit_plugins 职能。另一种方法是为插件和主题选项也使用 manage_options 这个职能.
2. 添加设置
以下函数，可以编辑、修改、增加后台设置菜单的页面功能，以及新增菜单页面。
register_setting 注册的能够通过表单自动更新、add_option 只是普通的选项；

 register_setting('reading', 'wporg_setting_name',["type"=>"boolean","description"=>"描述"]); 为指定页面注册一个新设置（系统默认的有“general”、“discussion”、“media”、“reading”、“writing”和“options”），可以通过 get_option 获取 register_setting 的值；
add_settings_section($id,$title,$callback,$page)，在指定的设置页面（$page）上添加一个标题为 $title、内容为 $callback 输出的新分节。
add_settings_field($id,$title,$callback,$page,$section,$args)，将指定标题的 callback 内容的新字段添加指定页面的指定分节上面。
unregister_setting()，如字面意思；
settings_fields(string $option_group)，输出 register_setting 注册的所有输入域；参数为 option_group；（声明可以修改的选项）
do_settings_sections($page)，打印添加到特定设置页面的所有设置部分（HTML 代码）
submit_button(string $text = null, string $type = 'primary', string $name = 'submit', bool $wrap = true, array|string $other_attributes = null)，提供一个提交按钮；
settings_fields()、do_settings_sections()、do_settings_fields()、add_settings_error()、get_settings_errors()、settings_errors()

3.settings_fields()
用于输出表单带有表单提交时用于验证的 input 隐藏元素；
4.do_settings_sections
用于按照 wordpress 内置的格式输出表单的分节
5.do_settings_fields
用于按照指定的回调输出表单元素
文章密码处理

post_password_required()，判断文章是否需要输入密码、是否已经输入密码；
get_the_password_form()，输出用于密码输入的表单

文章评论
评论相关函数必须运行在 comments.php 内，其它文件内调用无返回结果；

have_comments()，判断当前文章是否有评论；
comments_open()，是否打开了评论功能；
comment_form()，输出评论的表单；
wp_list_comments()，输出评论列表；
the_comments_navigation()，显示上、下一组评论；
get_comments_number()，获取文章评论数量；
is_user_logged_in()，当前访客是否登录；
wp_get_current_user()，获取当前登录的对象，返回 WP_User 对象。
wp_get_current_commenter()，获取当前评论着的姓名、电子邮件和 URL。
paginate_comments_links()，评论的分页结构
get_cancel_comment_reply_link()，获取取消回复的链接
comment_form_title()，获取当前的评论状态；
$reply_to_id = isset($_GET['replytocom'] ) ? (int) $_GET['replytocom'] : 0;$comment = get_comment($reply_to_id); // 获取回复的评论；

数据库操作
相关文章：http://www.sins7.cn/wordpress-wpdb-usage/
$wpdb 是一个全局变量，包含多个关于数据库查询函数：
 get_results('query');  
$wpdb->query('query');  
$wpdb->get_var('query',column_offset,row_offset);  
$wpdb->get_row('query', output_type, row_offset);  
$wpdb->get_col('query',column_offset);  
$wpdb->get_results('query', output_type);  
$wpdb->insert($table, $data, $format);  
$wpdb->update($table, $data, $where, $format = null, $where_format = null);  
$wpdb->prepare('query' [, value_parameter, value_parameter ...] );  
$wpdb->show_errors();  
$wpdb->hide_errors(); 
$wpdb->print_error();  
$wpdb->get_col_info('type', offset);  
$wpdb->flush();
瞬态数据
相较于选项，瞬态的区别是可以设置数据到期时间。

set_transient($transient, $value, $expiration);
get_transient()，获取值
set_site_transient()，多站点时使用。
get_site_transient()多站点时使用。
delete_transient()，删除指定值。
delete_site_transient()，多站点时使用。

内置的时间单位常量：
MINUTE_IN_SECONDS  = 60 (seconds)
HOUR_IN_SECONDS    = 60 * MINUTE_IN_SECONDS
DAY_IN_SECONDS     = 24 * HOUR_IN_SECONDS
WEEK_IN_SECONDS    = 7 * DAY_IN_SECONDS
MONTH_IN_SECONDS   = 30 * DAY_IN_SECONDS
YEAR_IN_SECONDS    = 365 * DAY_IN_SECONDS

小部件 
小部件本质就是一段可直接调用的代码块（分为边栏和挂件）。官方文档：https://codex.wordpress.org/zh-cn:%E5%B0%8F%E5%B7%A5%E5%85%B7%E6%8E%A5%E5%8F%A3、https://automattic.com/code/widgets/api/
1.register_widget
register_widget 用于注册一个 Wordpress 默认的挂件；

提示

      经过测试，register_widget 注册的部件类中最终也是调用 wp_register_sidebar_widget（WP_Widget 类的 567 行调用了这个函数），注册的小部件。

2.the_widget
the_widget 调用后，将输出指定的挂件
3.register_sidebars
register_sidebars 用于注册一个侧边栏，可以指定一个索引进行注册
4.dynamic_sidebar
dynamic_sidebar 用于输出注册好的侧边栏，通过索引指定输出某一个侧边栏
5.wp_register_sidebar_widget
wp_register_sidebar_widget 用于注册一个边栏挂件。
5. is_active_sidebar('sidebar')
判断指定的边栏是否有被激活的小工具；
用户角色和权限
官方文档：https://wordpress.org/support/article/roles-and-capabilities/
1. 角色分类
WordPress 使用角色的概念来让博客的所有者对用户进行权限控制。博客所有者可以控制用户写文章、创建页面、管理插件、管理主题，以及管理其他用户的权限。博客所有者可以通过该工具分配用户权限。

Administrator – 系统管理员
Editor – 编辑，可以发布和编辑自己及他人发布的文章
Author – 作者，可以发布和管理他们自己的文章
Contributor –投稿者，他们可以投稿，和管理他们的文章，但是不能发布。
Subscriber – 订阅者，可以阅读评论和接收 newsletter

2.current_user_can()
判断当前登录的用户是否具有指定的权限；检查当前用户是否有足够的职能去执行某些行为（action）

3.author_can()

4. 自定义用户角色

添加了一个新的角色叫做“document_uploader”，显示名称“Document Uploader" 及一个职能的集合（在这个例子中，职能名称 organize_document)。可以使用 current_user_can()检查当前用户是否被允许执行相应操作。
5. 移除角色

6. 修改已有角色的权限
add_cap('organize_document');

wp 总数计算 
1.wp_count_posts
获取指定状态类型文章的总数量；
$count_posts = wp_count_posts();
 
if ($count_posts) {$draft_posts = $count_posts->draft;
}

2.wp_count_terms
wp_count_terms 用于获取标签或分类的总数；
wp_count_terms('category'); // 分类总数
wp_count_terms('post_tag'); // 标签总数

3. 评论总数
$comment =  count(get_comments());// 评论总数

wp 定时任务
1.wp_get_schedules
获取所有支持的定时任务时间间隔，看了一下源码，调用的是查看 cron_schedules filter 返回的数组；增加一个自定义的时间间隔：
 3600,
		'display' => '定时任务'  // 对于这个时间间隔的描述
	);
	return $schedules;	
   });

2.wp_schedule_event
wp_schedule_event 用于添加一个定时任务；
wp_schedule_event("初次触发时间","间隔触发时间","触发的 action hook");

3.wp_clear_scheduled_hook
wp_clear_scheduled_hook 用于清理定时任务；
4.wp_unschedule_event
wp_unschedule_event 用于删除一个间隔时间；

提示

      添加计划任务之后，这个任务就独立了，每次只会去触发 action，所有在插件被关闭后，没有这个 action 了，任务还会继续，所有在插件关闭时需要同步取消任务，同理表单的开关也需要同步任务的开启和关闭。

HTTP API
参考文档：https://developer.wordpress.org/plugins/http-api/

1.wp_remote_get()
wp_remote_get 用于进行 Get 请求，示例代码如下：

2. 获取请求结果

wp_remote_retrieve_body，获取响应的结果 Body
wp_remote_retrieve_response_code，获取响应的状态码
wp_remote_retrieve_header，获取指定的响应头

3.wp_remote_post
wp_remote_post 用于发起 POST 请求示例代码如下：
 $body,
    'timeout'     => '5',
    'headers'=>[],
    'cookies'=>[],
    'sslverify' => false,
    'redirection' => '5',
    'httpversion' => '1.0',
    'blocking'    => true,
    'headers'     => array(),
    'cookies'     => array(),);

$response = wp_remote_post('http://your-contact-form.com', $args);

4.wp_remote_request
wp_remote_request 用于进行自定义请求；

提示

      WP_Http_Curl 对于 HTTP 请求的封装
    

前端调用媒体中心
首先通过 wp_enqueue_media 加载前端所需的调用媒体中心的代码
wp.media({
  title: '选择或上传图片', // 窗口标题
  button: {text: '选择', // 选择按钮文字},
  editable:   true,
  allowLocalEdits: true,
  displaySettings: true,
  displayUserSettings: true
  multiple: false // 是否允许多选
});

// 获取被选数据
media.state().get('selection').toJSON()

同样的还可以通过加载 wp_enqueue_editor 调用编辑器。
1.wp_enqueue_media
wp_enqueue_media 用于加载 wp.media 所需的 JS 文件
相关文档：https://developer.wordpress.org/reference/functions/wp_enqueue_media/
2.wp.media
wp.media 用于前端创建一个 wp 媒体中心窗体。可传入参数如下：

frame，代表创建的窗体类型，可选值 select、post、manage、image、audio、video、edit-attachments
on()，绑定事件。
media.state().get('selection').toJSON());，被选的图片

wordpress 元框
1.add_meta_box
add_meta_box()函数是被用来在文章编辑等页面添加一个设置的区域的函数。
创建的文章类型默认的仅有标题、作者、分类、标签、日期和评论，这些也许对博客已经足够使用了，但是对于产品类型的文章来说，不仅仅需要标题和正文，还需要单独设置一些其它的参数，如产品价格、产品型号、规格大小等，那么就需要给文章类型添加 Meta Box，通俗点理解就是自定义字段表单，下面就来以实例讲解下这个函数的用法。



$id（字符串）（必需）字段 id，唯一
$title（字符串）（必需）标题名称，显示在文章编辑页面
$callback（回调）（必需）回调函数
$post_type（字符串）（必需）文章类型
$context（字符串）（可选）显示位置，文章编辑页面包括’normal’,‘side’, and‘advanced’的形式，Menus meta boxes 仅用’side’的形式
$priority（字符串）（可选）优先级，默认值：‘default’
$callback_args（数组）（可选）传递到 callback 函数的参数。callback 函数将接收 $post 对象和其他由这个变量传递的任何参数。

实际例子：
add_action('add_meta_boxes', 'product_price');
function product_price() {
    add_meta_box(
        'product_price',
        '产品价格',
        'product_price_meta_box',
        'store',
        'side',
        'low'
    );
}

输出表单之后，点击保存就会同时提交表单数据，wordpress 不会自动处理这部分数据，需要自己判断并编写处理逻辑
参考：https://www.wuyanshuo.cn/93.html、https://www.daimadog.com/2456.html/comment-page-1 
问题总结
1.save_post
wordpress 自动保存也会触发这个钩子，可能导致异常输出；save_post 钩子内进行 wp_update_post 会导致重复触发钩子
2. 获取页面使用的模板
$template=get_page_template_slug(get_queried_object_id() );
if (strpos($template,"template/page/posts.php") !== false) { }

3. 获取访问的目录和标签对象
term_id;
// 获取分类、标签的链接
get_term_link($tag->term_id); 
4. 获取作者的指定信息
author.php 页面可以通过这个函数获取需要的数据。
post_author )

5. 设置代理
http_api_curl 可以在请求之前对 curl 进行相关的处理。
add_filter('http_api_curl', function ( $handle, $args, $url) {curl_setopt( $handle, CURLOPT_PROXYTYPE, CURLPROXY_SOCKS5);
	curl_setopt($handle, CURLOPT_PROXY, "socks5://8.217.181.168:7858");
	curl_setopt($handle, CURLOPT_FOLLOWLOCATION, true);
	return $handle;
}, 10, 3 );

6. 对文章保存前的内容进行处理
wp_insert_post_data  在将文章数据插入数据库之前触发。可以使用这个钩子来修改保存的内容。
add_filter('wp_insert_post_data', 'my_custom_function', 10, 2);

function my_custom_function($data, $postarr) {
    // 获取保存的文章内容
    $content = $data['post_content'];
    // 在这里对内容进行自定义处理
    // 修改后的内容
    $data['post_content'] = $content;
    return $data;
}

content_save_pre 在将文章内容保存到数据库之前触发。可以使用这个钩子来对保存的内容进行进一步处理。
add_filter('content_save_pre', 'my_custom_function');

function my_custom_function($content) {
    // 在这里对内容进行自定义处理
    return $content;
}