Source: public/themes/blog/functions-post.php · 935 lines, ~5022 statements · namespace: (global) · `declare(strict_types=1)`: no
Blog Theme Post Helpers
Post retrieval, topic, tag, page and archive helpers for the Bootstrap Blog theme. Extracted from the monolithic functions.php (Phase 5 remediation). Raw SQL has been routed through PostDao so templates never reach into the database layer directly. All functions use function_exists() guards to avoid redeclaration errors.
| Function | Line | Params | Returns | Summary |
|---|---|---|---|---|
previous_post | 22 | 1 | previous_post() - Get previous post link | |
next_post | 50 | 1 | next_post() - Get next post link | |
initialize_page | 78 | 0 | initialize_page() | |
initialize_post | 88 | 0 | initialize_post() | |
initialize_comment | 98 | 0 | initialize_comment() | |
initialize_archive | 108 | 0 | initialize_archive() | |
initialize_topic | 118 | 0 | initialize_topic() | |
initialize_tag | 128 | 0 | initialize_tag() | |
initialize_gallery | 138 | 0 | initialize_gallery() | |
featured_post | 148 | 0 | featured_post() - Get random headline posts | |
sticky_page | 159 | 0 | sticky_page() - Get random sticky page | |
random_posts | 170 | 2 | random_posts() - Get random posts | |
latest_posts | 181 | 2 | latest_posts() - Get latest posts | |
prepare_post_card | 203 | 1 | \Scriptlog\Core\Theme\PostViewModel | prepare_post_card() - Normalize a raw post row into a display-ready card. |
theme_post_url | 260 | 1 | string | theme_post_url() - Build a post URL without a per-row database round-trip. |
theme_topic_url | 297 | 1 | string | theme_topic_url() - Build a category URL without a per-row DB round-trip. |
theme_page_url | 335 | 1 | string | theme_page_url() - Build a static page URL without a per-row DB round-trip. |
theme_search_url | 373 | 0 | string | theme_search_url() - Build the front-end search URL honoring the permalink setting. |
theme_tag_url | 399 | 1 | string | theme_tag_url() - Build a tag archive URL without a per-row DB round-trip. |
theme_month_name | 424 | 1 | string | theme_month_name() - Localized month number to English month name. |
theme_archive_url | 451 | 2 | string | theme_archive_url() - Build a monthly archive URL without a per-row DB |
prepare_page | 484 | 1 | prepare_page() - Normalize a raw page row into a display-ready PageViewModel. | |
prepare_archive | 528 | 1 | prepare_archive() - Normalize a raw archive row into a display-ready | |
prepare_sidebar | 555 | 0 | prepare_sidebar() - Normalize raw sidebar aggregates into a display-ready | |
format_topics | 639 | 1 | Format topics data into HTML category links | |
retrieves_topic_simple | 688 | 1 | retrieves_topic_simple() - Get topic links for post | |
retrieves_topic_prepared | 717 | 1 | retrieves_topic_prepared() - Get topic links with status check | |
sidebar_topics | 741 | 0 | sidebar_topics() - Get topics for sidebar | |
retrieve_tags | 752 | 0 | retrieve_tags() - Get tags for sidebar | |
link_tag | 762 | 1 | link_tag() - Generate tag links | |
link_topic | 778 | 1 | string | link_topic() - Generate topic link |
retrieve_blog_posts | 799 | 0 | retrieve_blog_posts() - Get all blog posts | |
retrieve_detail_post | 810 | 1 | retrieve_detail_post() - Get single post by ID | |
posts_by_archive | 836 | 1 | posts_by_archive() - Get posts by archive | |
archive_index | 847 | 0 | archive_index() - Get all archives for index | |
posts_by_tag | 858 | 1 | posts_by_tag() - Get posts by tag | |
searching_by_tag | 869 | 1 | searching_by_tag() - Full-text tag search | |
posts_by_category | 881 | 1 | posts_by_category() - Get posts by category | |
retrieve_archives | 894 | 0 | retrieve_archives() - Get archives for sidebar | |
retrieve_page | 905 | 2 | retrieve_page() - Get page by ID or slug | |
nothing_found | 921 | 0 | nothing_found() - Display “no posts” message |
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function previous_post($id)
previous_post() - Get previous post link
| Parameter | Type | Default | Description |
|---|---|---|---|
$id | (untyped) | required |
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function next_post($id)
next_post() - Get next post link
| Parameter | Type | Default | Description |
|---|---|---|---|
$id | (untyped) | required |
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function initialize_page()
initialize_page()
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function initialize_post()
initialize_post()
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function initialize_comment()
initialize_comment()
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function initialize_archive()
initialize_archive()
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function initialize_topic()
initialize_topic()
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function initialize_tag()
initialize_tag()
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function initialize_gallery()
initialize_gallery()
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function featured_post()
featured_post() - Get random headline posts
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function sticky_page()
sticky_page() - Get random sticky page
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function random_posts($start, $end)
random_posts() - Get random posts
| Parameter | Type | Default | Description |
|---|---|---|---|
$start | (untyped) | required | |
$end | (untyped) | required |
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function latest_posts($limit, $position = null)
latest_posts() - Get latest posts
| Parameter | Type | Default | Description |
|---|---|---|---|
$limit | (untyped) | required | |
$position | (untyped) | null |
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function prepare_post_card(array $entry): \Scriptlog\Core\Theme\PostViewModel
prepare_post_card() - Normalize a raw post row into a display-ready card.
| Parameter | Type | Default | Description |
|---|---|---|---|
$entry | array | required |
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function theme_post_url(array $row): string
theme_post_url() - Build a post URL without a per-row database round-trip.
| Parameter | Type | Default | Description |
|---|---|---|---|
$row | array | required |
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function theme_topic_url(array $row): string
theme_topic_url() - Build a category URL without a per-row DB round-trip.
| Parameter | Type | Default | Description |
|---|---|---|---|
$row | array | required |
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function theme_page_url(array $row): string
theme_page_url() - Build a static page URL without a per-row DB round-trip.
| Parameter | Type | Default | Description |
|---|---|---|---|
$row | array | required |
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function theme_search_url(): string
theme_search_url() - Build the front-end search URL honoring the permalink setting.
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function theme_tag_url(string $tag): string
theme_tag_url() - Build a tag archive URL without a per-row DB round-trip.
| Parameter | Type | Default | Description |
|---|---|---|---|
$tag | string | required | Raw tag value (display form) |
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function theme_month_name(string $month): string
theme_month_name() - Localized month number to English month name.
| Parameter | Type | Default | Description |
|---|---|---|---|
$month | string | required | Month as number (1 or 2 digits, e.g. “3” or “03”) |
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function theme_archive_url(string $month, string $year): string
theme_archive_url() - Build a monthly archive URL without a per-row DB
| Parameter | Type | Default | Description |
|---|---|---|---|
$month | string | required | Archive month (1 or 2 digits) |
$year | string | required | Archive year (4 digits) |
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function prepare_page(array $entry)
prepare_page() - Normalize a raw page row into a display-ready PageViewModel.
| Parameter | Type | Default | Description |
|---|---|---|---|
$entry | array | required |
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function prepare_archive(array $entry)
prepare_archive() - Normalize a raw archive row into a display-ready
| Parameter | Type | Default | Description |
|---|---|---|---|
$entry | array | required |
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function prepare_sidebar()
prepare_sidebar() - Normalize raw sidebar aggregates into a display-ready
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function format_topics($topics_data)
Format topics data into HTML category links
| Parameter | Type | Default | Description |
|---|---|---|---|
$topics_data | (untyped) | required | Pipe-delimited topic data from GROUP_CONCAT |
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function retrieves_topic_simple($id)
retrieves_topic_simple() - Get topic links for post
| Parameter | Type | Default | Description |
|---|---|---|---|
$id | (untyped) | required |
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function retrieves_topic_prepared($id)
retrieves_topic_prepared() - Get topic links with status check
| Parameter | Type | Default | Description |
|---|---|---|---|
$id | (untyped) | required |
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function sidebar_topics()
sidebar_topics() - Get topics for sidebar
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function retrieve_tags()
retrieve_tags() - Get tags for sidebar
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function link_tag($id)
link_tag() - Generate tag links
| Parameter | Type | Default | Description |
|---|---|---|---|
$id | (untyped) | required |
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function link_topic($id): string
link_topic() - Generate topic link
| Parameter | Type | Default | Description |
|---|---|---|---|
$id | (untyped) | required |
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function retrieve_blog_posts()
retrieve_blog_posts() - Get all blog posts
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function retrieve_detail_post($id)
retrieve_detail_post() - Get single post by ID
| Parameter | Type | Default | Description |
|---|---|---|---|
$id | (untyped) | required |
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function posts_by_archive(array $values)
posts_by_archive() - Get posts by archive
| Parameter | Type | Default | Description |
|---|---|---|---|
$values | array | required |
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function archive_index()
archive_index() - Get all archives for index
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function posts_by_tag($tag)
posts_by_tag() - Get posts by tag
| Parameter | Type | Default | Description |
|---|---|---|---|
$tag | (untyped) | required |
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function searching_by_tag($tag)
searching_by_tag() - Full-text tag search
| Parameter | Type | Default | Description |
|---|---|---|---|
$tag | (untyped) | required |
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function posts_by_category($topicId)
posts_by_category() - Get posts by category
| Parameter | Type | Default | Description |
|---|---|---|---|
$topicId | (untyped) | required |
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function retrieve_archives()
retrieve_archives() - Get archives for sidebar
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function retrieve_page($arg, $rewrite)
retrieve_page() - Get page by ID or slug
| Parameter | Type | Default | Description |
|---|---|---|---|
$arg | (untyped) | required | |
$rewrite | (untyped) | required |
Declared inside a guard (the project uses `if (!function_exists(…))` around global functions), so the declaration is conditional at load time.
public function nothing_found()
nothing_found() - Display “no posts” message
Generated by 'tools/gendoc'.