# Extending pages

Certain pages in Misago are simple containers for sections:

* User Control Panel
* User Profiles List
* User Profile

Each of those consists of its own layout and list of sections. For example, user profiles display user name, information about user status, and sections (tabs) with lists of user threads, posts, followers, name history, etc. ect..

Each section is associated to instance of special object, `misago.core.page.Page`, which contains list of all sections belonging to it. Those instances are `misago.users.sites.usercp`, `misago.users.sites.users_list` and `misago.users.sites.user_profile`.

`misago.core.page.Page` instances expose following API:

## `add_section(link, after=None, before=None, visible_if=None, get_metadata=None, **kwargs)`

Adds section to page. `after` and `before` arguments should be value of other page `link`. `visible_if` argument accepts callable that will be called with args passed to `get_pages` function on page render to resolve if link to page should be displayed. `get_metadata` can be callable returning additional computed metadata for this page. All other values passed to function call get preserved in order to make it easy for 3rd party developers to reuse mechanic for their apps.

`visible_if` and `get_metadata` functions are called with arguments that were passed to `get_sections` method.

## `get_sections(request, *args)`

Returns list of sections assigned to this page. Each section is a dict of kwargs passed to `add_section` with additional `is_active` argument that controls if selected page is displayed one and `metadata` dict if one is defined.

## `get_default_link()`

Returns default link name that should be used as argument for \`

\` template tag.

Default links for Misago user pages are available in templates through following variables:

* `USERCP_URL` - Default link to user control panel site.
* `USERS_LIST_URL` - Default link to users lists site.
* `USER_PROFILE_URL` - Default link to user profile site.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://misago.gitbook.io/docs/extendingpages.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.