| 1 | ## comments/
|
|---|
| 2 |
|
|---|
| 3 | This directory holds templates for displaying the comment loop and the comment form - what is typically called in by WordPress's `comment_template()` function.
|
|---|
| 4 |
|
|---|
| 5 | This level of abstraction us useful to be able to load in the comments and new comment form for a post/page via AJAX if desired.
|
|---|
| 6 |
|
|---|
| 7 |
|
|---|
| 8 | ## General Context
|
|---|
| 9 |
|
|---|
| 10 | When choosing a template to use in the General Context, the Carrington engine looks at the type of request is being fulfilled. It will identify the request as the home page, a category archive, and individual post, etc.
|
|---|
| 11 |
|
|---|
| 12 | There is additional checking done for single post requests. All options in the Content Context are supported here with a 'single-' prefix added to the file. See specifics below.
|
|---|
| 13 |
|
|---|
| 14 | A "default" template is required, and will be used when there are no other templates that match a given comment. This could be because no other templates have been created, or because the comment in question doesn't match the templates that are available.
|
|---|
| 15 |
|
|---|
| 16 | By default, conditions are checked in this order:
|
|---|
| 17 |
|
|---|
| 18 | 1. author
|
|---|
| 19 | 2. role
|
|---|
| 20 | 3. category
|
|---|
| 21 | 4. tag
|
|---|
| 22 | 5. single
|
|---|
| 23 | 6. default (home, search, archivem 404, etc.)
|
|---|
| 24 |
|
|---|
| 25 | This can be altered using the `cfct_general_match_order` hook.
|
|---|
| 26 |
|
|---|
| 27 |
|
|---|
| 28 | ### Supported Templates (General Context)
|
|---|
| 29 |
|
|---|
| 30 | - *{dirname}-default.php* (or default.php) - Used when there are no other templates that match for a given page/post.
|
|---|
| 31 | - *archive.php* - Used for date archives or if there are no specific category, author or tag templates.
|
|---|
| 32 | - *author.php* - Used for author archive lists.
|
|---|
| 33 | - *author-{username}.php* - Used when the post/page is authored by a specific user. For example, a template with a file name of _author-jsmith.php_ would be used for a post/page by user _jsmith_. Any WordPress username can take the place of {username} in the file name.
|
|---|
| 34 | - *category.php* - Used for category archive lists.
|
|---|
| 35 | - *cat-{slug}.php* - Used fr displaying a given category. The category is matched by the "slug" - for example a post in category "General" (with a category slug of "general") could use a template of _cat-general.php_.
|
|---|
| 36 | - *home.php* - Used when on the home page.
|
|---|
| 37 | - *page.php* - Used for pages that do not match any other contextual templates.
|
|---|
| 38 | - *role-{rolename}.php
|
|---|
| 39 | - *search.php* - Used when displaying search results.
|
|---|
| 40 | - *single.php* - Used for single post pages.
|
|---|
| 41 | - *single-{content context filenames}.php* - Used for single post pages.
|
|---|
| 42 | - *tag.php* - Used for tag archive lists.
|
|---|
| 43 | - *tag-{slug}.php* - Used for displaying a given tag. The tag is matched by the "slug" - for example a post in tag "News" (with a tag slug of "news") could use a template of _tag-news.php_.
|
|---|
| 44 |
|
|---|
