Wordpress短代码传递值数组

时间:2015-07-09 02:52:12

标签: php wordpress shortcode

我正在创建一些WordPress短代码,旨在提供页面上的内部导航(一页包含大量内容部分和自己的菜单)。

这就是我所拥有的:

//menu
function internal_menu($atts) {
  extract(shortcode_atts(array(
   'href1' => '#jl1',
   'href2' => '#jl2',
   'href3' => '#jl3',
   'href4' => '#jl4',
  ), $atts));
  return '<div id="internalPageMenu">
    <ul>
        <li><a href="' . $href1 . '"><i class="fa fa-bars"></i>link 1</a></li>
        <li><a href="' . $href2 . '">link 2</a></li>
        <li><a href="' . $href3 . '">link 3</a></li>
        <li><a href="' . $href4 . '">link 4</a></li>
    </ul>
    </div>';
}
add_shortcode('internal-menu', 'internal_menu');

//menu target
function internal_menu_target($atts) {
  extract(shortcode_atts(array(
   'id' => 'jl1',
   'text' => '',
   ), $atts));
   return '<h3 id="' . $id . '">' . $text . '</h3>';
}
add_shortcode('internal-menu-target', 'internal_menu_target');

在我的Wordpress管理面板中使用它:

[internal-menu]
[internal-menu-target id="jl1"]
Some content
[internal-menu-target id="jl2"]
...etc...

如何使菜单动态化(不限于它可以拥有的项目数量)?例如,短代码将是:

[internal-menu targets="jl1, jl2, jl3, jl4, jl5, ...etc..."]

3 个答案:

答案 0 :(得分:13)

foreach将是您的答案。在我看来,这将是最简单,最干净的。在我给你一个代码示例之前,让我们分析你的代码并查看你的所有缺陷以及我们将如何纠正它们

缺陷

  • 永远不要使用extract()exctract()动态创建变量,这是有问题的。您无法正确调试extract(),如果您甚至可以),所以当它失败时,您实际上已经为您完成了不必要的工作。由于这些原因,它完全从核心和手抄本中删除。见trac ticket 22400。你应该有一个邪恶的清单,其中前两位是query_postsextract(),这两个位置有多糟糕。

  • 您没有清理和验证输入数据,这可能导致黑客将jquery注入您的代码以破解您的网站。 从不信任来自用户端和网址的任何数据,它可能会被感染。

  • 如您所知,从您的代码中获取,短代码不能除数组值外,其值必须为字符串。在您的情况下,我们需要从字符串值创建一个数组。同样,因为您无法信任用户在逗号之前或之后不使用空格,所以明智地建议删除所有空格(如果有),以便explode函数正确创建数组

  • 使用这种新方法,您需要确保字符串中的值的顺序正确,并且字符串是正确的长度。如果没有,您将获得意外的输出

让我们解决第一个短代码:( 请注意: 以下所有代码均未经过测试。可能有错误或语法错误

internal-menu

//menu
function internal_menu( $atts ) 
{
    $attributes = shortcode_atts(
        array(
           'href' => '',
         ), 
        $atts
    );

    $output = '',
    // Check if href has a value before we continue to eliminate bugs
    if ( !$attribute['href'] )
        return $output;
    // Create our array of values
    // First, sanitize the data and remove white spaces
    $no_whitespaces = preg_replace( '/\s*,\s*/', ',', filter_var( $attributes['href'], FILTER_SANITIZE_STRING ) ); 
    $href_array = explode( ',', $no_whitespaces );

    $output .= '<div id="internalPageMenu">';
        $output .= '<ul>';

            foreach ( $href_array as $k => $v ) { 
                // From your code, link 1 is different, so I kept it as is
                if ( $k == 0 ) {
                    $output .= '<li><a href="#' . $v . '"><i class="fa fa-bars"></i>link 1</a></li>';
                } else { 
                    $output .= '<li><a href="#' . $v . '">link ' . ($k + 1 ) . '</a></li>';
                }
            }

        $output .= '</ul>';
    $output .= '</div>';

    return $output;
}
add_shortcode( 'internal-menu', 'internal_menu' );

然后您可以使用以下短代码

[internal-menu href='jl1, jl2, jl3, jl4']

internal-menu-target

//menu target
function internal_menu_target($atts) 
{
    $attributes = shortcode_atts(
        array(
           'id' => '',
           'text' => '',
         ), 
        $atts
    );

    $output = '',
    // Check if href has a value before we continue to eliminate bugs
    if ( !$attribute['id'] || !$attribute['text'] )
        return $output;

    // Create our array of values
    // First, sanitize the data and remove white spaces
    $no_whitespaces_ids = preg_replace( '/\s*,\s*/', ',', filter_var( $attributes['id'], FILTER_SANITIZE_STRING ) ); 
    $ids_array = explode( ',', $no_whitespaces_ids );

    $no_whitespaces_text = preg_replace( '/\s*,\s*/', ',', filter_var( $attributes['text'], FILTER_SANITIZE_STRING ) ); 
    $text_array = explode( ',', $no_whitespaces_text );

    // We need to make sure that our two arrays are exactly the same lenght before we continue
    if ( count( $ids_array ) != count( $text_array ) )
        return $output;

    // We now need to combine the two arrays, ids will be keys and text will be value in our new arrays
    $combined_array = array_combine( $ids_array, $text_array );
    foreach ( $combined_array as $k => $v )
        $output .= '<h3 id="' . $k . '">' . $v . '</h3>';

    return $output;
}
add_shortcode('internal-menu-target', 'internal_menu_target');

您可以使用以下短代码:

[internal-menu-target id='1,2,3,4' text='text 1, text 2, text 3, text 4']

答案 1 :(得分:1)

问题:

WordPress短代码在可以传递的数据格式上有一些痛苦的限制...

以空格分隔的变量:

[shortcode a="1 2"]

结果:$atts=['a'='"1', 0='2"']

']'关闭短代码:

[shortcode b=[yay]]

结果:$atts=['b'='[yay']

解决方案:

您可以使用urlencode()来解决此问题:

[shortcode atts=a=1+2&b=%5Byay%5D]

像这样解析它:

parse_string($atts['atts'],$atts);

结果:$atts=['a'=>'1 2', b=>'[yay]']

这将为您提供所需的数组传递。

现在要构建菜单:

function internal_menu($atts) {
  // allow passing + and ] in the text of the links:
  parse_string($atts["links"],$links);

  // the defaults, verbatim from the question:
  if (!count($links)) $links=[
    'href1' => '#jl1',
    'href2' => '#jl2',
    'href3' => '#jl3',
    'href4' => '#jl4',
  ];

  foreach ($links as $text=>$href) $ul=."<li><a href=\"$href\">$text</a></li>";

  return '<div id="internalPageMenu"><ul>'.$ul.'</ul></div>';
}

add_shortcode('internal-menu', 'internal_menu');

//menu target

function internal_menu_target($atts) {
  // allow passing + and ] in the text:
  if (@$atts[text]) $atts['text']) = urldecode($atts['text']);

  // the defaults, verbatim from the question:
  $atts=array($atts)+['text'=>'','id'=>'jl1'];

  return '<h3 id="' . $link['id'] . '">' . $link['text'] . '</h3>';
}

add_shortcode('internal-menu-target', 'internal_menu_target');

,然后像这样喂它:

[internal-menu links=First+Link=#jl1&Second+Link=#jl2&Google=https://google.com]

[internal-menu-target text=Section+1 id=jl1]

如果您负责任地使用BTW extract(),那就非常好:

/* concatenates 3 words of wisdom into a polite policy direction
 *
 * @param $attr: hash of function args
 *          foo = the first word (Kindly)
 *          bar = the second word (ignore)
 *          baz = the third word (totalitarians)
 */

function excellent_policy($attr){
  $defaults=['foo'=>'Kindly', 'bar'=>'ignore', 'baz'=>'totalitarians'];
  extract((array)array_intersect_key($attr,$defaults)+$defaults);
  echo "$foo $bar $baz!";
}

这会将$ attr的$ foo,$ bar和$ baz以可读且可预测的方式从$ attr导入本地范围,为那些未传递的变量提供默认值,并防止创建任何意外变量。

使用语言功能的方法有好有坏。 禁止每个人因为某人使用不佳而不能使用某种语言功能,就像禁止每个人呼吸一样,因为某人可能会尝试吸入Jello。

答案 2 :(得分:0)

我使用的简单方法:

[my param="key1=value1&key2=value2"]

在简码回调中,只需执行以下操作:

parse_str( str_replace("&amp;", "&", $attrs['param']), $array);
// var_dump( $array );