App Configuration

The app.php file contains most application specific configuration items. This document provides an list of configuration items available in the app.php file, allowing you to modify them as necessary.

Contents

For details on how to set the below configuration items, please read: Updating Config Files.

Throttling

SupportPal throttles ticket requests by user email address, to ensure users do not spam the help desk. The functionality is particularly useful in the case of email where automated replies cause hundreds of tickets to be generated.

Ticket Throttling

Name Description Valid values Default
ticket_throttle_max_requests The maximum number of tickets a user is allowed to create before further attempts are blocked, also see: ticket_throttle_decay.
integer
3
ticket_throttle_decay The number of minutes before ticket requests are decayed. For example, by default a user can create 3 tickets within 5 minutes.
integer
5

Email Throttling

Name Description Valid values Default
email_throttle_max_requests The maximum number of emails a user is allowed to send to the help desk before further attempts are blocked, also see: email_throttle_decay.
integer
5
email_throttle_decay The number of minutes before email requests are decayed. For example, by default a the same email address can send 5 emails to the help desk within 15 minutes.
integer
15

Timeouts

Name Description Valid values Default
ldap_timeout The number of seconds to wait before timing out the connection to the LDAP server.
integer
5
scheduled_task_timeout The number of seconds to wait before resetting a scheduled task (default: 15 minutes).
integer
900
confirm_password_timeout How often operators are asked to confirm their password when making changes to other operator accounts (in seconds, default: 10 minutes). Set to -1 to completely disable the "Confirm Password" field.
integer
600

Tickets

Name Description Valid values Default
empty_ticket_trash The number of days after which tickets in the trash are deleted permanently automatically, counts from when the ticket was moved to the trash.
integer
30

Ticket Messages

Name Description Valid values Default
message_load_no The number of messages to pre load when viewing a ticket irrespective of max_message_size.

Set to null to pre load all messages. Note: this may introduce performance issues when loading large tickets with large messages.

Messages which are not preloaded will show an excerpt and the full text will be loaded dynamically when viewed by an end user.
integer
2
message_load_limit This setting relates to message_load_no and is best described through an example. If a ticket contains 40 messages and message_load_no is 2, there are 38 remaining messages. When message_load_limit is 20, 20 of those 38 messages, which are less than max_message_size, will be pre loaded.

Set to null to pre load all messages which are less than max_message_size. Note: this may introduce performance issues when loading large tickets with large messages.

Messages which are not pre loaded will show an excerpt and the full text will be loaded dynamically when viewed by an end user.
integer
20
message_load_order If we wish to automatically load the latest (default) or earliest message_load_limit messages when loading the ticket.
asc, desc
desc
max_message_size Messages that are greater than this size in bytes will be truncated.
The original message can be viewed by clicking the "View entire message" link at the bottom of the message.

It is not possible to disable this setting. Set it to a high value instead.

Note: browsers will typically crash if large volumes of text are pre loaded.
integer (bytes)
102000

Log Files

Name Description Valid values Default
raw_email_expiry_days The number of days that raw email log files are stored on the file system. Emails from pre-2.4.0 are stored in the database and must be pruned via the System Cleanup tool.
integer
30

Other

Name Description Valid values Default
ldap_dual_login If operators can log in with their regular operator login as well as their LDAP account.
bool
false
total_visible_recipients The total number of recipients that should be visible when viewing the e-mail log. If there are more addresses, "and x others" will be shown.
integer
2
timeago Can be used to disable the relative times (e.g. '1 hour ago') throughout the system.
bool
true
selfservice_articles The number of articles to show per category in the self-service by default, for 'hierarchical' types only.
integer
3
force_disable_ssl Disable SSL redirection middleware.
Use only when Enable SSL is toggled on in SupportPal and HTTPS connections are broken.
bool
false