首页>建站相关>写一个typecho后台设置页之单选框

写一个typecho后台设置页之单选框

typecho实现主题设置页的控件继承自同一个类,所以它们支持同样数量的参数,但对于某些空间来说,其中某几个参数是不必要的,但这一节中的单选框元素,就是一个集齐了5个参数的狠角色,在functions.php中,我们利用这个类来实现一个单选框。

参数回顾

Typecho_Widget_Helper_Form_Element_Text这个类支持5个参数,兄弟类Typecho_Widget_Helper_Form_Element_Radio也一样,不同的是,对于Radio元素来说,这5个参数都有用武之地:

  • $name 表单输入项名称
  • $options 选择项
  • $value 表单默认值
  • $label 表单标题
  • $description 表单描述

程序展现与源代码

function themeConfig($form) {
    $searchForm= new Typecho_Widget_Helper_Form_Element_Radio('searchForm', array(
        'white' => '白色',  
        'black' => '黑色'
    ), 'white', _t('导航栏颜色'), _t('用户可以选择是否开启搜索功能'));
    $form->addInput($searchForm);
}

这是一段示例的程序,虽然提供了单选框的默认值,但在实际的测试中,这个默认值并没有起到应有的作用,展现于后台的初始状态如下图,程序设置了默认值为“white”,但后台初始化后,白色按钮并没有被选中:

typecho_theme_options_radio_p1

此时用如下语句意图打印searchForm的值是没有效果的:

<?php if($this-&gt;options-&gt;searchForm){echo 'My value is '.$this->options->searchForm;} ?>

选中白色并保存设置后,页面会打印出如下结果:

My value is white

在部分主题中看到过这种语法:

<?php if($this-&gt;options-&gt;searchForm){echo 'My value is '.$this->options->searchForm();} ?>

加上括号后,刚才输出在屏幕上的“My value is white”的语序会变为这样:

whiteMy value is

在不加括号的时候,语句返回一个值给了echo函数,供echo拼接字符串使用,而加了括号以后,语句不再返回值,而是象一个立即执行的函数一样直接在屏幕上输出了内容,所以就有了语序上的变化。

多行模式

单选框可选项目较多时,我们也可以考虑将可选择项目多行排列,比如将程序修改如下:

function themeConfig($form) {
    $searchForm= new Typecho_Widget_Helper_Form_Element_Radio('searchForm', array(
        'red' => '红色',
        'yellow' => '黄色',
        'blue' => '蓝色',
        'white' => '白色',
        'black' => '黑色'
    ), NULL, _t('导航栏颜色'), _t('用户可以选择是否开启搜索功能'));
    $form-&gt;addInput($searchForm -> multiMode());
}

修改为上述语句后“设置外观”页面的展现如下图:

typecho_theme_options_radio_p2

垃圾回收机制

有一个需要留意的问题是,如果不想在代码中保留上述选项,并且在functions.php中明确删除了上面示例中的代码,searchForm的值还是能够被提取到,所以仅删除掉代码是不够的,我们需要在“设置外观”页面下重新点击保存设置,此时没有被引用的值才会被清除,所以修改代码之后,记得要及时保存一下设置。

如何让默认值生效

最初以为是自己设置的问题,在另一个typecho博客上尝试后,发现默认值同样是无法生效的,也就是设置完funcions.php之后,并不会触发数据的更新,但安装一个新的主题后,确实是有默认设置的,区别就在于,新安装主题后有一个启用的步骤,于是将主题换成另一个,然后重新启用回来,发现默认值正确得到了显示。

标签: typecho

移动端可扫我直达哦~

推荐阅读

typecho 2025-04-29

typecho让后台设置的代码更为易读

利用deepseek写一个简单的后台控件类,来简化一下后台的书写,利用这个类,我们可以把参数以数组的形式组装在一起,由类来轮询读取并生成控件。一个简单的后台实现类if (!class_exists('Aug_Config')) { ...

建站相关 typecho

typecho 2025-04-20

关于typecho主题的目录结构

wordpress的极简主题需要有两个文件,分别是index.php以及style.css,而在typecho中,因为主题的一些配置信息默认被放在了index.php而不是style.css文件中,所以直接往主题包里仍一个index....

建站相关 typecho

typecho 2025-04-20

从零开始做一个 Typecho 主题系列

Typecho是一款轻量级、高效的开源博客程序,由国内开发者团队开发维护。它采用PHP语言编写,支持MySQL、SQLite等多种数据库,安装包体积仅有500KB左右,运行时内存占用极低,却能提供出色的性能表现。这款博客程序最大的特点...

建站相关 typecho

typecho 2025-04-18

Typecho_Db 类以及各方法基础用例

Typecho_Db 是 Typecho 博客系统的数据库操作核心类,提供了数据库连接、查询构建和执行等功能。Typecho_Db 提供了简洁高效的数据库操作接口,是Typecho插件和主题开发中最常用的类之一。主要功能数据库连接管理...

建站相关 typecho

typecho 2025-04-16

typecho 1.2.1 给标签添加description说明文字

之前写过一篇为typecho标签添加说明字段的方法,对应的是typecho1.1版本,目前typecho的稳定版本是1.2.1, 因为服务器php版本较低,一直没有去尝试新版。这几天用小皮面板搭建了一个本地的php环境,终于是正经尝试...

建站相关 typecho

typecho 2025-04-11

Typecho博客系统中的config.inc.php文件

在 Typecho 博客系统中,config.inc.php 是一个核心配置文件,用于存储数据库连接信息和系统关键设置。它通常位于 Typecho 的安装根目录下,在安装过程中自动生成。Typecho 的安装包解压后并不包含这个文件,...

建站相关 typecho

typecho 2025-04-09

Typecho尝试获取主题的一些基础信息

在Typecho的主题一览里是利用了一个循环来遍历主题,遍历主题的时候可以通过activated参数来确定是否是当前主题,这样就可以利用官方提供的函数来获取主题信息了,缺点很明显,需要多使用一个循环,浪费资源。<?php \Wi...

建站相关 typecho

typecho 2025-04-02

typecho模板解析优先级

类似于wordpress ,Typecho的模板系统也遵循特定的优先级规则,当系统寻找模板文件时会按照以下顺序进行查找:模板文件查找优先级主题自定义模板 (最高优先级)usr/themes/[主题名]/[模板文件]例如:usr/the...

建站相关 typecho

typecho 2025-03-27

typecho如何实时更新被修改后的style.css文件

给新的站点“biib.top”加了个友情链接,顺便修改了一下主题的footer背景。但浏览器缓存了站点的css文件,修改后的效果并不实时生效。直接清除浏览器缓存是个简单粗暴的办法,问题在于这个效果也只是针对博主个人,用户可不会没事瞎清...

建站相关 typecho

typecho 2024-04-20

typecho根据标签的slug name信息判断是否输出免责声明

博主是从事机械行业的,工作过程中接触了很多二手老旧的设备,因为是二手设备,不缺胳膊少腿能正常运行已是难得,完善的说明书与售后服务想都不要想了。所以找设备的说明书成了一项附加的工作,总得让设备正常运行起来,偶尔设备有个小病小痛的,也不能...

建站相关 typecho

typecho 2023-11-02

Typecho开发文档-Widget设计文档

什么是WidgetWidget是组成Typecho的最基本元素,除了已经抽象出来的类库外,其它几乎所有的功能都会通过Widget来完成.在实践中我们发现,在博客这种小型但很灵活的系统中实施一些大型框架的思想是不合适的,它会使系统灵活性...

建站相关 typecho