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

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
主站蜘蛛池模板: 涡阳县| 隆回县| 阳曲县| 靖宇县| 柳州市| 万载县| 永春县| 黎城县| 巴马| 临武县| 建湖县| 廊坊市| 全南县| 乌兰浩特市| 蚌埠市| 依兰县| 子洲县| 和顺县| 通海县| 新沂市| 理塘县| 晋江市| 昭平县| 扬州市| 孟州市| 马边| 内丘县| 永州市| 安康市| 辛集市| 黄石市| 游戏| 大理市| 哈尔滨市| 锡林郭勒盟| 富源县| 轮台县| 廊坊市| 井冈山市| 绥芬河市| 临清市|