Class forum_driver_none

Description
Description | Vars | Methods (details)

Located in /sources/forum/none.php (line 21) 

forum_driver_base
   |
   --forum_driver_none
Method Summary
Description | Vars | Methods (details)
array find_emoticons ()
array forum_authorise_login (?SHORT_TEXT $username, MEMBER $userid, MD5 $password_hashed, string $password_raw, [boolean $cookie_login = false])
?LANGUAGE_NAME forum_get_lang (MEMBER $member)
integer forum_id_from_name (SHORT_TEXT $forum_name)
string get_admin_username ()
?array get_custom_fields (MEMBER $member)
tempcode get_emoticon_chooser ([string $field_name = 'post'])
URLPATH get_emo_dir ()
mixed get_forum_topic_posts (SHORT_TEXT $forum_name, SHORT_TEXT $topic_name)
MEMBER get_guest_id ()
?array get_matching_members (string $pattern, [?integer $limit = NULL])
integer get_members ()
URLPATH get_member_avatar_url (MEMBER $member)
boolean get_member_email_allowed (MEMBER $member)
MEMBER get_member_from_username (SHORT_TEXT $name)
IP get_member_ip (MEMBER $id)
TIME get_member_join_timestamp (MEMBER $member)
URLPATH get_member_photo_url (MEMBER $member)
?MEMBER get_next_member (MEMBER $member)
integer get_num_forum_posts ()
?integer get_num_users_forums ()
integer get_post_count (MEMBER $member)
?MEMBER get_previous_member (MEMBER $member)
integer get_tid_from_topic (SHORT_TEXT $topic, string $forum)
integer get_topics ()
integer get_topic_count (MEMBER $member)
array get_top_posters (integer $limit)
boolean install_create_custom_field (string $name, integer $length)
array install_get_path_search_list ()
array install_specifics ()
boolean install_test_load_from (PATH $path)
boolean is_banned (MEMBER $member)
boolean is_cookie_login_name ()
boolean is_hashed ()
void make_post_forum_topic (SHORT_TEXT $forum_name, SHORT_TEXT $topic_name, MEMBER $member, tempcode $post, LONG_TEXT $title, tempcode $topic_for, [?TIME $time = NULL], [?IP $ip = NULL])
?array member_group_query (array $groups, [?integer $max = NULL], [integer $start = 0])
URLPATH member_home_link (MEMBER $id)
URLPATH member_profile_link_name (SHORT_TEXT $name)
?array pget_row (SHORT_TEXT $name)
TIME pnamelast_visit (array $r)
SHORT_TEXT pname_email (array $r)
GROUP pname_group (array $r)
MEMBER pname_id (array $r)
string pname_name (array $r)
URLPATH post_link (integer $id, string $forum)
array probe_ip (IP $ip)
void set_custom_field (MEMBER $member, string $field, string $amount)
?array show_forum_topics (SHORT_TEXT $name, integer $limit, integer $start, integer &$max_rows, [SHORT_TEXT $filter_topic_name = ''], [boolean $show_first_posts = false], [string $date_key = 'lasttime'], [boolean $hot = false], [SHORT_TEXT $filter_topic_description = ''])
URLPATH topic_link (integer $id, string $forum)
URLPATH _forum_link (integer $id)
array _get_members_groups (MEMBER $member)
SHORT_TEXT _get_member_email_address (MEMBER $member)
array _get_moderator_groups ()
integer _get_num_new_forum_posts ()
array _get_super_admin_groups ()
ID_TEXT _get_theme ()
array _get_usergroup_list ()
?SHORT_TEXT _get_username (MEMBER $member)
boolean _is_staff (MEMBER $member)
boolean _is_super_admin (MEMBER $member)
URLPATH _join_link ()
URLPATH _member_pm_link (MEMBER $id)
URLPATH _member_profile_link (MEMBER $id)
URLPATH _online_link ()
Variables
Description | Vars (details) | Methods (details)

Inherited Variables

Inherited from forum_driver_base

forum_driver_base::$connection
 forum_driver_base::$MEMBER_ROWS_CACHED
Methods
Description | Vars Methods (details)
find_emoticons (line 188)

Get a map between smiley codes and templates representing the HTML-image-code for this smiley. The smilies present of course depend on the forum involved.

  • return: The map
array find_emoticons ()
forum_authorise_login (line 853)

Find if the given member id and password is valid. If username is NULL, then the member id is used instead.

All authorisation, cookies, and form-logins, are passed through this function. Some forums do cookie logins differently, so a Boolean is passed in to indicate whether it is a cookie login.

  • return: A map of 'id' and 'error'. If 'id' is NULL, an error occured and 'error' is set
array forum_authorise_login (?SHORT_TEXT $username, MEMBER $userid, MD5 $password_hashed, string $password_raw, [boolean $cookie_login = false])
  • ?SHORT_TEXT $username: The member username (NULL: don't use this in the authentication - but look it up using the ID if needed)
  • MEMBER $userid: The member id
  • MD5 $password_hashed: The md5-hashed password
  • string $password_raw: The raw password
  • boolean $cookie_login: Whether this is a cookie login
forum_get_lang (line 55)

Attempt to to find the member's language from their forum profile. It converts between language-identifiers using a map (lang/map.ini).

  • return: The member's language (NULL: unknown)
?LANGUAGE_NAME forum_get_lang (MEMBER $member)
  • MEMBER $member: The member who's language needs to be fetched
forum_id_from_name (line 429)

Get the forum id from a forum name.

  • return: The forum id
integer forum_id_from_name (SHORT_TEXT $forum_name)
  • SHORT_TEXT $forum_name: The forum name
get_admin_username (line 29)

Get the administration username for the site.

  • return: The admin username
string get_admin_username ()
get_custom_fields (line 228)

Get custom profile fields values for all 'ocp_' prefixed keys.

  • return: A map of the custom profile fields, key_suffix=>value (NULL: no fields)
?array get_custom_fields (MEMBER $member)
  • MEMBER $member: The member id
get_emoticon_chooser (line 158)

Get an emoticon chooser template.

  • return: The emoticon chooser template
tempcode get_emoticon_chooser ([string $field_name = 'post'])
  • string $field_name: The ID of the form field the emoticon chooser adds to
get_emo_dir (line 178)

Find the base URL to the emoticons.

  • return: The base URL
URLPATH get_emo_dir ()
get_forum_topic_posts (line 482)

Get an array of maps for the topic in the given forum.

  • return: The array of maps (Each map is: title, message, member, date) (-1 for no such forum, -2 for no such topic)
mixed get_forum_topic_posts (SHORT_TEXT $forum_name, SHORT_TEXT $topic_name)
  • SHORT_TEXT $forum_name: The forum name
  • SHORT_TEXT $topic_name: The topic name
get_guest_id (line 86)

Find the member id of the forum guest member.

  • return: The member id of the forum guest member
MEMBER get_guest_id ()
get_matching_members (line 659)

Find all members with a name matching the given SQL LIKE string.

  • return: The array of matched members (NULL: none found)
?array get_matching_members (string $pattern, [?integer $limit = NULL])
  • string $pattern: The pattern
  • ?integer $limit: Maximum number to return (limits to the most recent active) (NULL: no limit)
get_members (line 750)

Get the number of members registered on the forum.

  • return: The number of members
integer get_members ()
get_member_avatar_url (line 334)

Get the avatar URL for the specified member id.

  • return: The URL (blank: none)
URLPATH get_member_avatar_url (MEMBER $member)
  • MEMBER $member: The member id
get_member_email_allowed (line 634)

Find if this member may have e-mails sent to them

  • return: Whether the member may have e-mails sent to them
boolean get_member_email_allowed (MEMBER $member)
  • MEMBER $member: The member id
get_member_from_username (line 791)

Get a member id from the given member's username.

  • return: The member id
MEMBER get_member_from_username (SHORT_TEXT $name)
  • SHORT_TEXT $name: The member name
get_member_ip (line 882)

Get a first known IP address of the given member.

  • return: The IP address
IP get_member_ip (MEMBER $id)
  • MEMBER $id: The member id
get_member_join_timestamp (line 646)

Get the timestamp of a member's join date.

  • return: The timestamp
TIME get_member_join_timestamp (MEMBER $member)
  • MEMBER $member: The member id
get_member_photo_url (line 321)

Get the photo URL for the specified member id.

  • return: The URL (blank: none)
URLPATH get_member_photo_url (MEMBER $member)
  • MEMBER $member: The member id
get_next_member (line 585)

Get the member id of the next member after the given one, or NULL.

It cannot be assumed there are no gaps in member ids, as members may be deleted.

  • return: The next member id (NULL: no next member)
?MEMBER get_next_member (MEMBER $member)
  • MEMBER $member: The member id to increment
get_num_forum_posts (line 770)

Get the total posts ever made on the forum.

  • return: The number of posts
integer get_num_forum_posts ()
get_num_users_forums (line 740)

Get the number of members currently online on the forums.

  • return: The number of members (NULL: NA)
?integer get_num_users_forums ()
get_post_count (line 672)

Get the given member's post count.

  • return: The post count
integer get_post_count (MEMBER $member)
  • MEMBER $member: The member id
get_previous_member (line 572)

This is the opposite of the get_next_member function.

  • return: The previous member id (NULL: no previous member)
?MEMBER get_previous_member (MEMBER $member)
  • MEMBER $member: The member id to decrement
get_tid_from_topic (line 442)

Get the topic id from a topic name in the specified forum. It is used by comment topics, which means that the unique-topic-name assumption holds valid.

  • return: The topic id
integer get_tid_from_topic (SHORT_TEXT $topic, string $forum)
  • SHORT_TEXT $topic: The topic name
  • string $forum: The forum id
get_topics (line 760)

Get the total topics ever made on the forum.

  • return: The number of topics
integer get_topics ()
get_topic_count (line 684)

Get the given member's topic count.

  • return: The topic count
integer get_topic_count (MEMBER $member)
  • MEMBER $member: The member id
get_top_posters (line 43)

Get the rows for the top given number of posters on the forum.

  • return: The rows for the given number of top posters in the forum
array get_top_posters (integer $limit)
  • integer $limit: The limit to the number of top posters to fetch
install_create_custom_field (line 98)

Add the specified custom field to the forum (some forums implemented this using proper custom profile fields, others through adding a new field).

  • return: Whether the custom field was created successfully
boolean install_create_custom_field (string $name, integer $length)
  • string $name: The name of the new custom field
  • integer $length: The length of the new custom field
install_get_path_search_list (line 147)

Get an array of paths to search for config at.

  • return: The paths in which to search for the forum config
array install_get_path_search_list ()
install_specifics (line 115)

Get an array of attributes to take in from the installer. Almost all forums require a table prefix, which the requirement there-of is defined through this function.

The attributes have 4 values in an array

  • name, the name of the attribute for info.php
  • default, the default value (perhaps obtained through autodetection from forum config)
  • description, a textual description of the attributes
  • title, a textual title of the attribute

  • return: The attributes for the forum
array install_specifics ()
install_test_load_from (line 131)

Searches for forum auto-config at this path.

  • return: Whether the forum auto-config could be found
boolean install_test_load_from (PATH $path)
  • PATH $path: The path in which to search
is_banned (line 696)

Find out if the given member id is banned.

  • return: Whether the member is banned
boolean is_banned (MEMBER $member)
  • MEMBER $member: The member id
is_cookie_login_name (line 76)

Find if the login cookie contains the login name instead of the member id.

  • return: Whether the login cookie contains a login name or a member id
boolean is_cookie_login_name ()
is_hashed (line 66)

Find if login cookie is md5-hashed.

  • return: Whether the login cookie is md5-hashed
boolean is_hashed ()
make_post_forum_topic (line 463)

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). Note that $post should be in HTML, and some forums do not store posts as HTML. This is unfortunate, but there are some limits to just how far you can reasonably integrate with all these different forum systems without making a programatic mess.

void make_post_forum_topic (SHORT_TEXT $forum_name, SHORT_TEXT $topic_name, MEMBER $member, tempcode $post, LONG_TEXT $title, tempcode $topic_for, [?TIME $time = NULL], [?IP $ip = NULL])
  • SHORT_TEXT $forum_name: The forum name
  • SHORT_TEXT $topic_name: The topic name
  • MEMBER $member: The member id
  • tempcode $post: The post content
  • LONG_TEXT $title: The post title
  • tempcode $topic_for: The content title the topic is related to
  • ?TIME $time: The post time (NULL: use current time)
  • ?IP $ip: The post IP address (NULL: use current members IP address)
member_group_query (line 559)

Get an array of members who are in at least one of the given array of usergroups.

  • return: The array of members (NULL: no members)
?array member_group_query (array $groups, [?integer $max = NULL], [integer $start = 0])
  • array $groups: The array of usergroups
  • ?integer $max: Return up to this many entries for primary members and this many entries for secondary members (NULL: no limit, only use no limit if querying very restricted usergroups!)
  • integer $start: Return primary members after this offset and secondary members after this offset
member_home_link (line 309)

Get a URL to the specified member's home (control panel).

  • return: The URL to the members home
URLPATH member_home_link (MEMBER $id)
  • MEMBER $id: The member id
member_profile_link_name (line 366)

Get a URL to the specified member's profile, from the username.

  • return: The URL to the member profile
URLPATH member_profile_link_name (SHORT_TEXT $name)
  • SHORT_TEXT $name: The username
pget_row (line 240)

Get a member profile-row for the member of the given name.

  • return: The profile-row (NULL: no row)
?array pget_row (SHORT_TEXT $name)
  • SHORT_TEXT $name: The member name
pnamelast_visit (line 275)

From a member profile-row, get the member's last visit date.

  • return: The last visit date
TIME pnamelast_visit (array $r)
  • array $r: The profile-row
pname_email (line 298)

From a member profile-row, get the member's e-mail address.

  • return: The member e-mail address
SHORT_TEXT pname_email (array $r)
  • array $r: The profile-row
pname_group (line 252)

From a member profile-row, get the member's primary usergroup.

  • return: The member's primary usergroup
GROUP pname_group (array $r)
  • array $r: The profile-row
pname_id (line 264)

From a member profile-row, get the member's member id.

  • return: The member id
MEMBER pname_id (array $r)
  • array $r: The profile-row
pname_name (line 287)

From a member profile-row, get the member's name.

  • return: The member name
string pname_name (array $r)
  • array $r: The profile-row
post_link (line 510)

Get a URL to the specified post id.

  • return: The URL to the post
URLPATH post_link (integer $id, string $forum)
  • integer $id: The post id
  • string $forum: The forum id
probe_ip (line 596)

Try to find a member with the given IP address

  • return: The distinct rows found
array probe_ip (IP $ip)
  • IP $ip: The IP address
set_custom_field (line 215)

Set a custom profile fields value. It should not be called directly.

void set_custom_field (MEMBER $member, string $field, string $amount)
  • MEMBER $member: The member id
  • string $field: The field name
  • string $amount: The value
show_forum_topics (line 539)

Get an array of topics in the given forum. Each topic is an array with the following attributes:

  • id, the topic id
  • title, the topic title
  • lastusername, the username of the last poster
  • lasttime, the timestamp of the last reply
  • closed, a Boolean for whether the topic is currently closed or not
  • firsttitle, the title of the first post
  • firstpost, the first post (only set if $show_first_posts was true)

  • return: The array of topics (NULL: error)
?array show_forum_topics (SHORT_TEXT $name, integer $limit, integer $start, integer &$max_rows, [SHORT_TEXT $filter_topic_name = ''], [boolean $show_first_posts = false], [string $date_key = 'lasttime'], [boolean $hot = false], [SHORT_TEXT $filter_topic_description = ''])
  • SHORT_TEXT $name: The topic name
  • integer $limit: The limit
  • integer $start: The start position
  • integer &$max_rows: The total rows (not a parameter: returns by reference)
  • SHORT_TEXT $filter_topic_name: The topic name filter
  • boolean $show_first_posts: Whether to show the first posts
  • string $date_key: The date key to sort by
  • boolean $hot: Whether to limit to hot topics
  • SHORT_TEXT $filter_topic_description: The topic description filter
topic_link (line 496)

Get a URL to the specified topic id. Most forums don't require the second parameter, but some do, so it is required in the interface.

  • return: The URL to the topic
URLPATH topic_link (integer $id, string $forum)
  • integer $id: The topic id
  • string $forum: The forum id
_forum_link (line 417)

Get a URL to the specified forum.

  • return: The URL to the specified forum
URLPATH _forum_link (integer $id)
  • integer $id: The forum id
_get_members_groups (line 835)

Get the forum usergroup relating to the specified member id.

  • return: The array of forum usergroups
array _get_members_groups (MEMBER $member)
  • MEMBER $member: The member id
_get_member_email_address (line 622)

Get the e-mail address for the specified member id.

  • return: The e-mail address
SHORT_TEXT _get_member_email_address (MEMBER $member)
  • MEMBER $member: The member id
_get_moderator_groups (line 814)

Get the ids of the moderator usergroups.

It should not be assumed that a member only has one usergroup - this depends upon the forum the driver works for. It also does not take the staff site filter into account.

  • return: The moderator usergroup ids
array _get_moderator_groups ()
_get_num_new_forum_posts (line 780)

Get the number of new forum posts.

  • return: The number of posts
integer _get_num_new_forum_posts ()
_get_super_admin_groups (line 803)

Get the ids of the admin usergroups.

  • return: The admin usergroup ids
array _get_super_admin_groups ()
_get_theme (line 708)

Try to find the theme that the logged-in/guest member is using, and map it to an ocPortal theme.

The themes/map.ini file functions to provide this mapping between forum themes, and ocPortal themes, and has a slightly different meaning for different forum drivers. For example, some drivers map the forum themes theme directory to the ocPortal theme name, whilst others made the humanly readeable name.

  • return: The theme
ID_TEXT _get_theme ()
_get_usergroup_list (line 824)

Get the forum usergroup list.

  • return: The usergroup list
array _get_usergroup_list ()
_get_username (line 609)

Get the name relating to the specified member id.

If this returns NULL, then the member has been deleted. Always take potential NULL output into account.

  • return: The member name (NULL: member deleted)
?SHORT_TEXT _get_username (MEMBER $member)
  • MEMBER $member: The member id
_is_staff (line 719)

Find if the specified member id is marked as staff or not.

  • return: Whether the member is staff
boolean _is_staff (MEMBER $member)
  • MEMBER $member: The member id
_is_super_admin (line 730)

Find if the specified member id is marked as a super admin or not.

  • return: Whether the member is a super admin
boolean _is_super_admin (MEMBER $member)
  • MEMBER $member: The member id
_join_link (line 384)

Get a URL to the registration page (for people to create member accounts).

  • return: The URL to the registration page
URLPATH _join_link ()
_member_pm_link (line 405)

Get a URL to send a private/personal message to the given member.

  • return: The URL to the private/personal message page
URLPATH _member_pm_link (MEMBER $id)
  • MEMBER $id: The member id
_member_profile_link (line 347)

Get a URL to the specified member's profile.

  • return: The URL to the member profile
URLPATH _member_profile_link (MEMBER $id)
  • MEMBER $id: The member id
_online_link (line 394)

Get a URL to the members-online page.

  • return: The URL to the members-online page
URLPATH _online_link ()

Inherited Methods

Inherited From forum_driver_base

forum_driver_base::disable_staff_filter()
forum_driver_base::forum_link()
forum_driver_base::get_guest_group()
forum_driver_base::get_members_groups()
forum_driver_base::get_member_email_address()
forum_driver_base::get_moderator_groups()
forum_driver_base::get_num_new_forum_posts()
forum_driver_base::get_super_admin_groups()
forum_driver_base::get_theme()
forum_driver_base::get_usergroup_list()
forum_driver_base::get_username()
forum_driver_base::is_staff()
forum_driver_base::is_super_admin()
forum_driver_base::join_link()
forum_driver_base::member_pm_link()
forum_driver_base::member_profile_hyperlink()
forum_driver_base::member_profile_link()
forum_driver_base::online_link()

Documentation generated on Sun, 02 Jan 2011 23:19:06 +0000 by phpDocumentor 1.4.3