This function does a lot of work in setting up a ticket to be displayed:

• Invokes shd_load_ticket() to get the principle data
• Creates $context['ticket'] to hold the data block, some of which is derived from the return of shd_load_ticket():
  • id: regular numeric ticket id
  • display_id: zero padded ticket id (e.g. 00001)
  • subject: censored version of the subject
  • first_msg: id of the opening post that forms the ticket body
  • body: formatted (parsed for smileys and bbcode) version of the ticket post
  • id_member: user id of the ticket's poster
  • id_member_assigned: user id of the ticket's assigned user
  • member: hash array of the ticket poster's details:
    • id: their user id
    • name: the name stated in the ticket post for that use
    • link: link to the profile of the user
  • assigned: hash array of the assignee of the ticket:
    • id: their user id
    • name: name of the assignee, or 'Unassigned'
    • link: a full HTML link to their profile, or 'Unassigned' in red text
  • assigned_self: boolean, whether the ticket is assigned to the current user or not
  • ticket_opener: boolean, whether the current user is the user who opened this ticket
  • urgency: hash array
    • level: numeric identifier of current ticket urgency
    • label: the HTML label of the urgency, including being in red for "Very High" or above
    • increase: Boolean, whether the current ticket urgency can be increased given the current ticket state and user permissions
    • decrease: Boolean, whether the current ticket urgency can be increased given the current ticket state and user permissions
  • status: hash array
    • level: numeric, current status identifier
    • label: string representing the current status
  • num_replies: the number of replies to the ticket so far
  • deleted_replies: how many deleted replies in this ticket
  • poster_time: formatted string containing the time the ticket was opened
  • privacy: hash array
    • label: current label to be used with the privacy item
    • can_change: Boolean, whether the user's permission with this ticket allows us to edit the ticket privacy
  • closed: Boolean, represents whether this ticket is closed (used a lot with the navigation menu)
  • deleted: Boolean, represents whether this ticket is deleted (used a lot with the navigation menu)
  • ip_address: IP address logged at the time the ticket was opened; if moderate_forum_members permission is available, this will be a link to the track IP area
  • modified: if the ticket has been modified, also get the modified details:
    • id: user id who edited the ticket (not always available)
    • time: formatted string of the time the post was edited
    • timestamp: raw timestamp of the time the post was edited
    • name: user name of the editing user; if we have a definite user id, this should contain the current name, falling back to the previously stored name
    • link: if we have a known, valid user id for the post's editor, this will contain a link to their profile, with the link text using their current display name; alternatively it will contain a regular string which is the username stored with the edit.
  • display_recycle: Either holds the $txt identifier of the message to apply as a warning, or false if displaying of recycling stuff in this ticket isn't appropriate (either for permissions or just because of no deleted replies, or we're just in regular ticket view)
• define the page index with SMF's constructPageIndex
• query for all the ids of messages we might display, followed by querying for the message details themselves, pushing that query resource to $reply_request so we can use it in shd_view_replies() later
• load details of all the users applicable for posts in this page
• request all the visible attachments from {@link}
• since we are viewing this ticket, mark it read
• set up the breadcrumb trail
• set up the ticket navigation menu
• call in the editor component from SimpleDesk-Post.php and friends, ready for Quick Reply
• invoke the different Javascript objects that are applicable on the page:
  • privacy changer
  • urgency changer
  • quick reply / quote / go advanced

• see: \shd_prepare_ticket_context()
• since: 1.0

The process set up by shd_view_ticket() and invoked within template_view_replies() is reasonably complex. {@link} identifies what messages should be displayed on the current page of the ticket, and performs a query to load the ticket data. Instead, however, of retrieving every row directly into memory before passing to the template, it passes the query result, and the name of a handler function into $context, so the template can call to get an individual row at a time, which saves memory amongst other things. With respect to {@link}, the relevant items are $reply_request being defined and $context['get_replies'] being defined as the name of this function, and in {@link}, the reference is $reply = $context['get_replies']()

• see: \shd_view_ticket()
• since: 1.0

Queries the {db_prefix}helpdesk_attachments table for the current ticket, or the messages that will be displayed (previously identified by {@link}) and loads the id, name and size of them for display purposes. Differentiation between "attach to ticket" and "attach to reply" is made here; the data is loaded differently depending on the context; "attach to ticket" is simply loaded into an indexed array stored in $context['ticket_attach']['ticket'], while "attach to reply" is loaded into an indexed array subset in $context['ticket_attach']['reply'][msg_id] to retain the association.

• since: 1.0

Parameter: $attach_info

Expected type: mixed

Returns the icon name to use given the filename, i.e. looks up icons from a list of known extensions.

• see: \shd_display_load_attachments()
• since: 1.0

Parameter: $filename

Expected type: string

The filename of an attachment.

Queries the system for all tickets related to the specified (typically current) ticket, subject to current user's permissions, and populates $context. The function populates $context['relationships_count'] with the number of relationships found, and $context['ticket_relationships'] contains an array of the following keys: - parent: Current ticket is the parent of the discovered ticket - child: Current ticket is a child of the discovered ticket - linked: Current ticket is related to discovered ticket - duplicated: Curent ticket is a duplicate of discovered ticket Each of the keyed arrays is an indexed array (each index representing one ticket), of which those are hash arrays containing: - id: id of the ticket - display_id: zero padded display id of the ticket - subject: ticket's name - status: status of the discovered ticket (numeric) - status_txt: status of the discovered ticket (textual)

• since: 2.0

Parameter: $ticket

Expected type: mixed