官术网_书友最值得收藏!

Setting page attributes

Pages, like most objects in concrete5, can have any type of custom attribute attached to them. This allows for immense flexibility, but it can be difficult to read and write these attributes using raw SQL. The concrete5 API makes setting and reading page attributes easy.

Getting ready

You will need to know at least the handle of the attribute key that you wish to assign to the page. A common attribute to set is the Meta Title attribute, which updates the text that appears in the HTML <title> tag.

How to do it...

We will set the Meta Title attribute to the About Us page in this example. The steps are as follows:

  1. Open /config/site_post.php in your preferred code editor.
  2. Load the Page object that you wish to set the attribute on.
    $page = Page::getByPath('/about');
  3. Call the setAttribute function on the $page object, passing in two parameters: the attribute handle (key), and the value.
    $page->setAttribute('meta_title', 'New Page Meta Title');
  4. Output a success message and exit the process.
    echo 'done!';
    exit;

How it works...

The setAttribute function is a member of the Collection class, which the Page class extends. It requires that you provide two parameters, an attribute key (which can either be a string representing the attribute key handle (which we provided here), or an actual AttributeKey object), and the value.

There's more...

The setAttribute function is very handy for setting the data of any kind of page attribute. One can update a page's meta information (such as description, keywords, and title) and also give the page various options, such as, excluding it from the navigation (as seen previously) or from the sitemap.xml file that search engines look for.

You can update any attribute that has been installed in the concrete5 system. To see all available page attributes, or to create new ones, visit the Page Attributes area of your site's dashboard (located at /dashboard/pages/attributes/).

See also

  • The Getting a page by its path recipe
  • The Getting a page attribute recipe
主站蜘蛛池模板: 梅河口市| 邵阳市| 吉木乃县| 靖边县| 乌什县| 澄城县| 祁阳县| 湛江市| 石台县| 文安县| 五家渠市| 瓮安县| 德清县| 天气| 宁河县| 自贡市| 峡江县| 平舆县| 巴青县| 当阳市| 清镇市| 呼玛县| 清丰县| 砚山县| 屯留县| 南陵县| 社旗县| 通海县| 兴海县| 原平市| 东台市| 汶川县| 霍山县| 繁峙县| 南郑县| 西安市| 蕉岭县| 菏泽市| 分宜县| 三门峡市| 绥芬河市|