本文章为 WordPress网盘链接检测插件 新增自定义配置的教程。

一.在插件目录 wpmel_url_check/op/ 文件夹下新增配置文件夹，配置结构如下：

|--diyname    配置文件夹，可自定义名称
    |--diyname.php    配置主文件,文件名需与配置文件夹名一致
    |--style.css      配置信息文件，并在该配置生效时自动加载该样式文件到wp_head

二.style.css 文件结构：

需先在顶部输入下方注释信息，并将配置名称、作者信息等改成自己的信息，该文件会在配置生效时自动加载到wp_head，所以可在该文件直接写入各种CSS样式，无需手动记载CSS文件。

/*!
op_name:配置名称
op_Author:作者信息
op_Version:版本信息
op_date:配置时间
op_desc:配置介绍
!*/

三.diyname.php 主配置文件介绍

1.首先要在该文件创建一个wpmel_default_parameter()函数，该函数为配置信息函数，具体参数如下：

function wpmel_default_parameter(){
    $return_arr = array(
        'btn_html' => '<div class="mel_check_con"><button type="button" class="mel_check_pan btn btn-primary">'.mel_p('check_btn_title','检测下载链接') .'</button></div>',//默认检测按钮HTML
        'btn_class' => '.mel_check_con .mel_check_pan',//按钮CLASS
        'div_class' => '.mel_check_con',//检测按钮DIV框架CSS，用于检测时替换HTML
        'btn_testing' => '<div class="text btn btn-primary">\'+iconspin + \' 正在检测</div>',//检测时HTML
        'normal_class' => 'text btn btn-info',//正常时按钮class
        'invalid_class' => 'text btn btn-danger',//失效时按钮class
        'auto_add_btn' => true,//前端是否自动添加按钮
        'auto_add_btn_op' => array(
            '.riplus-widget-down .other-info' => 'prepend',
            '.pay-info .btn-groups'          => 'append'
        ), //键值填写需要操作的元素，内容可选 append（在元素的结尾插入内容） prepend（在元素的开头插入内容） after（在元素之后插入内容） before（在元素之前插入内容）###相同元素只能操作一次
        'shortcode' => true,//是否开启短代码功能
    );
    return $return_arr;
}

2.然后创建一个wpmel_testing_url()函数，该函数的作用为将需要检测的链接数据拼接成一个字符串，示例如下：

function wpmel_testing_url($post_id){ //将需要检测的链接拼接成字符串
     $array = _get_post_down_info($post_id); //下载信息;
     $return_url = "";

    foreach((array)$array as $item){
        if(is_array($item)){
            $return_url .= $item['url'].'</br>';
        }
        
    }
    return $return_url;
}

该函数无特别要求，最后将拼接成的网址字符串 return 就行，特别需要注意的是，每个网址之间需要用“空格”或者“”隔开。

3.可选函数：wpmel_default_options后台配置函数

使用该函数可在后台设置添加可供用户设置的选项，ripro配置就使用了该函数，具体使用方法如下：

function wpmel_default_options(){
    $array = array();
    $array[] =  array(
        'id'      => 'ripro_check_free',
        'type'    => 'switcher',
        'title'   => '是否检测免费链接',
        'default' => false,
    );
    $array[] =  array(
        'id'      => 'ripro_check_free1',
        'type'    => 'switcher',
        'title'   => '是否检测免费链接1',
        'default' => false,
    );
    return $array;
}

设置后使用 wpmel_get_diy_op($id,$default) 函数获取该字段配置信息；

4.可选函数：mel_shortcode_check 短代码函数

如第一步设置wpmel_default_parameter() 函数时 'shortcode' 设置为 true 时，则该函数为必须，主要作为为开启短代码功能时显示相应的html，该函数无具体格式要求，仅需将使用短代码时需要显示的html return 即可，示例如下：

function mel_shortcode_check( $attr, $content ){
		if(is_have_pan(get_the_ID())){
			return '<div class="mel_check_con"><button type="button" class="mel_check_pan btn badge-primary btn--block">'.mel_p('check_btn_title','检测下载链接').'</button></div>';
		}
		
	}

四.可能会用到的函数

get_post_meta( $post_id, $key = '', $single = false ) //获取自定义字段
implode($glue, $array) //数组转字符串
is_have_pan($post_id) //判断指定文章是否包含支持检测的链接