正确理解Wordpress设置API

Wordpress设置API使用起来并不算太方便,很多地方都容易混淆,因此在本人读懂并改写了主题相关的设置类之后,就想把相关容易混淆的地方详细说明一下。

函数register_settingsettings_fields为一组,它们之间使用参数option_group进行关联,另外函数register_setting注册了get_option函数所需要的参数option_name。这两个函数一个用于注册设置信息,一个用于显示设置信息(实际即一组hidden属性的input标签,显示时使用参数option_group)。

函数add_settings_sectionadd_settings_fieldadd_[theme或options]_page为一组,它们之间使用参数menu_slug进行关联,由该参数可知这些函数只与某个特别的page相关,用于注册表单展示信息。使用函数do_settings_sections来渲染展示表单(显示时使用参数menu_slug)。

关于settings的状态栏使用<?php settings_errors(); ?>,该函数即可显示黄色的状态栏。更多状态栏相关开发参考这个链接

 

Post Series插件(更名为SimplePostSeries)正式发布

Post Series插件改名为Simple Post Series正式在Wordpress插件官网发布,可以自由下载使用

Simple Post Series为Wordpress增加按照专题管理文章并展示的功能,集所有类似插件功能之所长,设置选项完善。

融合所有类似插件的相关功能:

  • *可以在文章编辑页面通过按钮与面板添加shortcode以展示某个专题下的文章列表,支持文章与页面,
  • *可以设置自动在文章页或主页上显示某个专题下的文章列表,可以设置展示摘要或缩略图,
  • *可以在管理员文章管理页面上对某个专题进行筛选,文章管理更加方便,
  • *2.0最新版支持文章拖拽添加到专题的功能,页面特别参考eg-series插件。
    专题文章的拖动管理页面,这是极其方便的管理页面,用户可以在该页面上自由拖动文章到某个专题,或是删除某个专题下的文章,或是改变文章的排序等。

待完善:(BUG列表)

1.页面无法在专题展示中列出

Description

simple-post-series allows you to insert series short code for displaying a bunch of posts in the same serie.
This plugin allows to include posts into series, to create, delete or rename series. It also includes widgets and shortcodes to display list of series, or the list of posts belonging to the series of the current post.

With this plugin, you can:

    • Add / Delete a post from a serie,
    • Create / Rename / Delete series,
    • Display the list of series in a post, or display this list in sidebar, with widgets for exemple,
    • Filter posts by a special serie in your admin post managent page,
    • Automatically insert the list of posts of a specific serie, without using shortcode.
      simple-post-series is TinyMCE Integrated. That means you don’t need to learn the shortcode syntax. The plugin add a button in the tinymce toolbar. You just have to click on this button, choose parameters/options, and click insert. That’s all, the shortcode will be insert into your post with the right parameters.

You can find latest source code in github project.

This plugin is enlighted by Tuts+ and their Sessions. You can find a very helpful cource in NetTuts+ to figure out how this plugin works in Wordpress.

Installation

  1. Uzip the simple-post-series.zip folder.
  2. Upload the simple-post-series folder to your /wp-content/plugins directory.
  3. In your WordPress dashboard, head over to the Plugins section.
  4. Activate Post Series.

Usage

simple post series adds two administration pages, a widget and shortcode.

Customize your theme

simple-post-series uses now a specific taxonomy to implement series. It means

    • You can build / customize a specific page in your theme to display the content of a serie.
      You can customize your theme by creating page like ‘taxonomy-series.php’ which overrides default archive page to display the content of a serie.
      A sample archive page template is located in ‘[simple-post-series]/template/taxonomy-series.php’ and you can freely modified it and place in your own theme.

Administration pages

  • * Series gives ability to change or rename series,
  • * Settings/Post Series contains all options of the plugin. In this page, you can activate the auto display feature.

Shortcodes

To display the list of series: [series options], with the following options:

  • * id of the series. Default ‘ ‘,
  • * slug of the series. Default ‘ ‘,
  • * title of the list. Default ‘ ‘,
  • * limit: number of series to display in the list. Default: -1 to display all series,
  • * show_future: displays unpublish posts in the series. Default: on,
  • * class_prefix: of the list section. Default ‘post-series’.

Screenshots

  1. Post Editing page: TinyMCE integration and additional metabox to quickly choose or add a serie 加入专题设置模块,
  2. List of posts in a serie 在文章页面展示专题列表,
  3. Easily manage series 拖拽管理专题下所属文章,
  4. TinyMCE window to choose shortcodes options, and insert shortcodes 文章编辑方便插入short code,
  5. Insert short code in edit post 插入short code的结果,
  6. Options page 插件设置页面,

Changelog

= 2.1 =

  • New: Fix bugs and improve code robustion

= 2.0 =

  • New: Add admin series bulk edition page for drag and drop posts to serie

= 1.3 =

  • New: Add option to choose where to display lists
  • New: Add option to choose to display excerpt
  • New: Add option to choose to display thumbnail

= 1.2 =

  • New: Add series filter in admin’s edit.php
  • New: optional load of the stylesheet
  • New: sample archive page for displaying series taxonomy in custom theme

= 1.1 =

  • New: add widget for post series with many options

= 1.0 =

  • Plugin released. Everything is new! Have to change name from post-series to simple-post-series.

WordPress专题系列文章管理插件Post Series发布

本人第二个WordPress个人制作插件Post Series也完成了。功能是显示一个系列文章的列表,需求很常见,但是搜到的插件要么功能过于复杂,要么就得收费

当然这个插件主要的展示代码逻辑也是来自一个Nettuts+教程《Adding Post Series Functionality to WordPress With Taxonomies》,但是本人将其发扬光大,为其加入了编辑器按钮及界面,还加入插件设置界面以及相应小工具,而且可以设置自动在文章页面展示系列文章列表,彻底省去添加short code的烦恼。

目前可定制性算是够强,下一步是参考其他Series插件继续完善一些功能。当然目前的第一步是发布到WordPress官网供大家下载。

首先是学习免费插件EG-Series

优点:其同样支持编辑器按钮(支持系列文章展示short code与展示所有系列的short code),可以用拖放的方式管理系列下的文章,为管理员导航栏增加菜单。居然使用的各种short code及tax设置都与本人写的通用。。。要好好学习。。。

缺点:默认样式很一般,勉强可以用

其次是参考免费插件Organize Series,其可以升级为付费版,只有付费版才支持short code与custom post type

优点:普通版可以完整设置展示的template(全部HTML代码都可以更改,这个定制性过强)设置使用默认css样式表,可以为系列添加特色图标,为文章管理页面加上系列一栏(展示系列名称与文章数目),可以进行filter筛选,同样可以为文章自动添加系列展示等(设置使用checkbox input可以学习),可以改变文章在系列中的序数(比较麻烦)。

缺点:默认样式很丑,默认展示位置很诡异,根本不适用,果然是逼人用付费版啊。

优化点Todo:

  1. 文章管理页面加上系列的filter,系列支持特色图标
  2. 设置是否使用默认css样式表,其他都改用checkbox来展示
  3. 增加系列展示的各种设置,如是否显示thumbnail或excerpt
  4. 增加系列内的导航,增加show all按钮
  5. 系列展示可以使用list或select,改变sort order
  6. 拖放的方式管理(同时可以参考收费插件)*
  7. 设置short code的名称*
  8. 设置自动展示的页面类型与位置及样式设置*
  9. 增加更多的模板编码*
  10. 设置界面分为几个section*

Post Switch插件发布

本人终于发布了首个WordPress个人制作插件Post Switch,该插件可以很方便的切换正在编辑的文章。主要是本人发现在WordPress后台修改同一分类下面的文章时,需要不断切换到“所有文章”界面再切换回“修改文章”界面,颇为不便,于是就想在“修改文章”界面添加一个选项栏可以选择同一个分类下面的任意文章进行切换。写完插件用起来个人感觉也还不错,至少目前满足了个人需求。

post-switch 显示

插件使用后的“编辑文章”界面,增加了Post Switch功能块

post-switch screenshot 2

Post Switch功能块,上面可以选择分类,下面可以选择文章进行切换

取英文名倒是费了些神,写英文的说明文档也很痛苦,说明本人英文还需要加强。插件项目的托管使用了Github,于是也捎带熟悉了Git的使用,感觉确实很好用。无奈WordPress官方却使用SVN,怎么把这两个结合起来还需要继续研究。同时后续准备加强分类的选项,除了文章所属分类外还准备显示分类的父分类,这样能够进行编辑切换的文章就更多更容易查找了。

WordPress官方提交插件的地址也十分难找,居然在个人管理界面里面都没有,这里也顺便给出吧:插件提交地址

Post Switch插件下载:

Github项目地址

WordPress官方地址

tag与category的使用与自定义标签的设计

WordPress中存在两种类型的分类:一种是tag,另一种是category。这两种分类的区别在于: category通常是有层次的,而tag是平行平等的。

一些著名博客如Smashing Magzine以及Nettut+是如何安排使用tag和category的呢?

最新Smashing Magzine主题是轻博客类型,完全放弃有层次的category,而全部采用平等的tag。

而传统博客类型的Nettut+基本采用category,其URL结构为/articles/javascript或是/tutorials/ 。tag用来标记类型如video或tips,该主题甚至可以结合两者进行查询。

WordPress中可以使用函数register_taxonomy注册自定义标签,区分是category类型还是tag类型的关键就是参数hierarchical。

本站总访问量