awesome9/options

WordPress 选项管理器。

1.0.1 2021-07-10 02:04 UTC

This package is auto-updated.

Last update: 2024-09-10 09:11:46 UTC


README

Awesome9 Latest Stable Version PHP from Packagist Total Downloads License

📃 关于选项

此包提供在 WordPress 中管理选项的便利性。

💾 安装

composer require awesome9/options

🕹 使用

首先,您需要为您的主题/插件注册选项。

Awesome9\Options\Options::get()
	->register(
		'awesome9',                 // Unique name which also can be used as function
		'_awesome9_plugin_options', // Option key for database
		// Defaults values.
		[
			'name' => 'Awesome9',
			'social' => [
				'facebook' => 'https://facebook.com',
				'twitter'  => 'https://twitter.com',
			]
		]
	);

在插件激活钩子中,您可以使用 install 方法将默认选项添加到系统中。

Awesome9\Options\Options::get()->install();

您可以通过使用选项名称来获取其值。您也可以使用 ID 作为路径来获取值。

Awesome9\Options\Options::get()->awesome9( 'name' ); // Awesome9
Awesome9\Options\Options::get()->awesome9( 'social.facebook' ); // https://facebook.com

您可以临时或永久更新选项的值。

// Temporary update for session.
Awesome9\Options\Options::get()->awesome9()->update( 'name', 'Awesome Nine' );

// Permenant update
Awesome9\Options\Options::get()->awesome9()->update( 'name', 'Awesome Nine', true );

您可以临时或永久从选项中删除值。

// Temporary remove for session.
Awesome9\Options\Options::get()->awesome9()->remove( 'name' );

// Permenant remove
Awesome9\Options\Options::get()->awesome9()->remove( 'name', true );

所有参数与 JSON 类相同。

📖 更新日志

查看更新日志文件