====== public/themes/blog/functions-post.php ======


**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.

======= Functions (41) =======

^ 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 |


======== previous_post() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function previous_post($id)
</code>

previous_post() - Get previous post link

^  Parameter ^  Type ^  Default ^  Description ^
|  ''$id'' |  ''(untyped)'' |  //required// |   |


======== next_post() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function next_post($id)
</code>

next_post() - Get next post link

^  Parameter ^  Type ^  Default ^  Description ^
|  ''$id'' |  ''(untyped)'' |  //required// |   |


======== initialize_page() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function initialize_page()
</code>

initialize_page()


======== initialize_post() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function initialize_post()
</code>

initialize_post()


======== initialize_comment() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function initialize_comment()
</code>

initialize_comment()


======== initialize_archive() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function initialize_archive()
</code>

initialize_archive()


======== initialize_topic() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function initialize_topic()
</code>

initialize_topic()


======== initialize_tag() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function initialize_tag()
</code>

initialize_tag()


======== initialize_gallery() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function initialize_gallery()
</code>

initialize_gallery()


======== featured_post() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function featured_post()
</code>

featured_post() - Get random headline posts


======== sticky_page() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function sticky_page()
</code>

sticky_page() - Get random sticky page


======== random_posts() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function random_posts($start, $end)
</code>

random_posts() - Get random posts

^  Parameter ^  Type ^  Default ^  Description ^
|  ''$start'' |  ''(untyped)'' |  //required// |   |
|  ''$end'' |  ''(untyped)'' |  //required// |   |


======== latest_posts() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function latest_posts($limit, $position = null)
</code>

latest_posts() - Get latest posts

^  Parameter ^  Type ^  Default ^  Description ^
|  ''$limit'' |  ''(untyped)'' |  //required// |   |
|  ''$position'' |  ''(untyped)'' |  ''null'' |   |


======== prepare_post_card() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function prepare_post_card(array $entry): \Scriptlog\Core\Theme\PostViewModel
</code>

prepare_post_card() - Normalize a raw post row into a display-ready card.

^  Parameter ^  Type ^  Default ^  Description ^
|  ''$entry'' |  ''array'' |  //required// |   |


======== theme_post_url() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function theme_post_url(array $row): string
</code>

theme_post_url() - Build a post URL without a per-row database round-trip.

^  Parameter ^  Type ^  Default ^  Description ^
|  ''$row'' |  ''array'' |  //required// |   |


======== theme_topic_url() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function theme_topic_url(array $row): string
</code>

theme_topic_url() - Build a category URL without a per-row DB round-trip.

^  Parameter ^  Type ^  Default ^  Description ^
|  ''$row'' |  ''array'' |  //required// |   |


======== theme_page_url() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function theme_page_url(array $row): string
</code>

theme_page_url() - Build a static page URL without a per-row DB round-trip.

^  Parameter ^  Type ^  Default ^  Description ^
|  ''$row'' |  ''array'' |  //required// |   |


======== theme_search_url() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function theme_search_url(): string
</code>

theme_search_url() - Build the front-end search URL honoring the permalink setting.


======== theme_tag_url() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function theme_tag_url(string $tag): string
</code>

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) |


======== theme_month_name() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function theme_month_name(string $month): string
</code>

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") |


======== theme_archive_url() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function theme_archive_url(string $month, string $year): string
</code>

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) |


======== prepare_page() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function prepare_page(array $entry)
</code>

prepare_page() - Normalize a raw page row into a display-ready PageViewModel.

^  Parameter ^  Type ^  Default ^  Description ^
|  ''$entry'' |  ''array'' |  //required// |   |


======== prepare_archive() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function prepare_archive(array $entry)
</code>

prepare_archive() - Normalize a raw archive row into a display-ready

^  Parameter ^  Type ^  Default ^  Description ^
|  ''$entry'' |  ''array'' |  //required// |   |


======== prepare_sidebar() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function prepare_sidebar()
</code>

prepare_sidebar() - Normalize raw sidebar aggregates into a display-ready


======== format_topics() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function format_topics($topics_data)
</code>

Format topics data into HTML category links

^  Parameter ^  Type ^  Default ^  Description ^
|  ''$topics_data'' |  ''(untyped)'' |  //required// |  Pipe-delimited topic data from GROUP_CONCAT |


======== retrieves_topic_simple() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function retrieves_topic_simple($id)
</code>

retrieves_topic_simple() - Get topic links for post

^  Parameter ^  Type ^  Default ^  Description ^
|  ''$id'' |  ''(untyped)'' |  //required// |   |


======== retrieves_topic_prepared() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function retrieves_topic_prepared($id)
</code>

retrieves_topic_prepared() - Get topic links with status check

^  Parameter ^  Type ^  Default ^  Description ^
|  ''$id'' |  ''(untyped)'' |  //required// |   |


======== sidebar_topics() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function sidebar_topics()
</code>

sidebar_topics() - Get topics for sidebar


======== retrieve_tags() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function retrieve_tags()
</code>

retrieve_tags() - Get tags for sidebar


======== link_tag() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function link_tag($id)
</code>

link_tag() - Generate tag links

^  Parameter ^  Type ^  Default ^  Description ^
|  ''$id'' |  ''(untyped)'' |  //required// |   |


======== link_topic() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function link_topic($id): string
</code>

link_topic() - Generate topic link

^  Parameter ^  Type ^  Default ^  Description ^
|  ''$id'' |  ''(untyped)'' |  //required// |   |


======== retrieve_blog_posts() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function retrieve_blog_posts()
</code>

retrieve_blog_posts() - Get all blog posts


======== retrieve_detail_post() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function retrieve_detail_post($id)
</code>

retrieve_detail_post() - Get single post by ID

^  Parameter ^  Type ^  Default ^  Description ^
|  ''$id'' |  ''(untyped)'' |  //required// |   |


======== posts_by_archive() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function posts_by_archive(array $values)
</code>

posts_by_archive() - Get posts by archive

^  Parameter ^  Type ^  Default ^  Description ^
|  ''$values'' |  ''array'' |  //required// |   |


======== archive_index() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function archive_index()
</code>

archive_index() - Get all archives for index


======== posts_by_tag() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function posts_by_tag($tag)
</code>

posts_by_tag() - Get posts by tag

^  Parameter ^  Type ^  Default ^  Description ^
|  ''$tag'' |  ''(untyped)'' |  //required// |   |


======== searching_by_tag() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function searching_by_tag($tag)
</code>

searching_by_tag() - Full-text tag search

^  Parameter ^  Type ^  Default ^  Description ^
|  ''$tag'' |  ''(untyped)'' |  //required// |   |


======== posts_by_category() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function posts_by_category($topicId)
</code>

posts_by_category() - Get posts by category

^  Parameter ^  Type ^  Default ^  Description ^
|  ''$topicId'' |  ''(untyped)'' |  //required// |   |


======== retrieve_archives() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function retrieve_archives()
</code>

retrieve_archives() - Get archives for sidebar


======== retrieve_page() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function retrieve_page($arg, $rewrite)
</code>

retrieve_page() - Get page by ID or slug

^  Parameter ^  Type ^  Default ^  Description ^
|  ''$arg'' |  ''(untyped)'' |  //required// |   |
|  ''$rewrite'' |  ''(untyped)'' |  //required// |   |


======== nothing_found() ========

//Declared inside a guard (the project uses `if (!function_exists(...))` around global functions), so the declaration is conditional at load time.//

<code>
public function nothing_found()
</code>

nothing_found() - Display "no posts" message


----

//Generated by 'tools/gendoc'.//