Function Forum_driver_none->make_post_forum_topic
Definitions
sources/forum/none.php
- Makes a post in the specified forum, in the specified topic according to the given specifications. If the topic doesn't exist, it is created along with a spacer-post.Spacer posts exist in order to allow staff to delete the first true post in a topic. Without spacers, this would not be possible with most forum systems. They also serve to provide meta information on the topic that cannot be encoded in the title (such as a link to the content being commented upon).
- Visibility: public
- Is abstract?: No
- Is static?: No
- Is final?: No
- Return: array
Parameters
| Name | Type | Default | Set | Range | Description |
|---|---|---|---|---|---|
| $forum_name | SHORT_TEXT | required parameter | N/A | N/A | The forum name |
| $topic_identifier | SHORT_TEXT | required parameter | N/A | N/A | The topic identifier (usually <content-type>_<content-id>) |
| $member_id | MEMBER | required parameter | N/A | N/A | The member ID |
| $post_title | LONG_TEXT | required parameter | N/A | N/A | The post title |
| $_post | LONG_TEXT | required parameter | N/A | N/A | The post content in Comcode format |
| $content_title | string | required parameter | N/A | N/A | The topic title; must be same as content title if this is for a comment topic |
| $topic_identifier_encapsulation_prefix | string | required parameter | N/A | N/A | This is put together with the topic identifier to make a more-human-readable topic title or topic description (hopefully the latter and a $content_title title, but only if the forum supports descriptions) |
| $content_url | ?URLPATH | Null | N/A | N/A | URL to the content (null: do not make spacer post) |
| $time | ?TIME | Null | N/A | N/A | The post time (null: use current time) |
| $ip | ?IP | Null | N/A | N/A | The post IP address (null: use current members IP address) |
| $validated | ?BINARY | Null | N/A | N/A | Whether the post is validated (null: unknown, find whether it needs to be marked not validated initially). This only works with the Conversr driver. |
| $topic_validated | ?BINARY | 1 | N/A | N/A | Whether the topic is validated (null: unknown, find whether it needs to be marked not validated initially). This only works with the Conversr driver. |
| $skip_post_checks | boolean | False | N/A | N/A | Whether to skip post checks |
| $poster_name_if_guest | SHORT_TEXT | Blank (empty string) | N/A | N/A | The name of the poster |
| $parent_id | ?AUTO_LINK | Null | N/A | N/A | ID of post being replied to (null: N/A) |
| $staff_only | boolean | False | N/A | N/A | Whether the reply is only visible to staff |
Return
- Topic ID (may be null), and whether a hidden post has been made
- Type: array
- Set: N/A
- Range: N/A