Some of the content in this section applies to the version 2.2 release of Blue Twilight, which is still in beta. Check the project’s releases page to see when this version is fully released, or to get the beta.

Blue Twilight allows you to configure the application to your liking.

To access the Settings section, you’ll first need to ensure you are logged in with an administration account.

Once logged in, click the “Manage” link in the top menu bar, followed by the “Settings” link on the right-hand side of the admin screen.

Blue Twilight PHP photo gallery configuration screen


The settings are organised into three sections: General, E-mail, Security and Analytics.


Gallery name

The name that appears in the browser’s title bar/tab, and next to the logo in the top navigation bar.

Date format

Your preferred format to use when displaying dates and times.


The visual theme to use for your gallery. Blue Twilight ships with two standard themes: Bootstrap 3 and Bootstrap 3 (Light.)

You can create your own themes and they will appear here. I also plan to develop other themes in the future.

Remove “powered by” notice from the public gallery

To spread the word and promote Blue Twilight to the world, the themes add a “powered by Blue Twilight” statement to the bottom of all visible pages. If you wish to turn this off you can check this box and it will no longer appear.

Please note: this still appears in the admin section to provide quick links back to my website.


The settings below apply to e-mails sent by Blue Twilight – such as password reminder e-mails.

Sender name

The name to appear as the “from” name in the e-mail. Defaults to your gallery’s name.

Sender address

The e-mail address to appear as the “from” address in the e-mail. Defaults to hostmaster@your-gallery-domain.


The hostname of the SMTP server to connect to. If your mail server is on the same server as the application, this will be “localhost.”


The port number of the SMTP server to connect to. This is usually port number 25.


The username to login to the SMTP server if authentication is required. Leave blank if authentication is not required.


The password to login to the SMTP server if authentication is required. Leave blank if authentication is not required.

Requires encrypted connection

Some SMTP servers require an encrypted connection. If yours is one of them, tick this box. Note you may need to change the port number if using encryption. Consult your hosting provider if you’re at all unsure.

Send a test e-mail

Once you’ve configured the settings above, click this button to send a test e-mail to the e-mail address of the account you’re currently logged in as.


Allow self-registration

If you want visitors to be able to create themselves an account, enable this option. If you want to create user accounts manually yourself, disable it.

It defaults to enabled.

Require e-mail verification for self-registered accounts

Enable this option to require that visitors must click a link in an e-mail sent to their e-mail address before their account is activated. This ensures the e-mail address they are using is valid.

It’s strongly recommended to leave this option enabled.

Enable reCAPTCHA for self-registrations

You can optionally enable Google’s reCAPTCHA service to make it more difficult for bots to register fake accounts. If you enable this option, you’ll need to add the keys provided to you by Google in the fields below.

It’s strongly recommended to enable this option.

Site key

If you enable the above reCAPTCHA option, you’ll need to set this field to the site key provided by Google.

Secret key

If you enable the above reCAPTCHA option, you’ll need to set this field to the secret key provided by Google.

Restrict access to original images

You may want to show off your photos but not want people to access the full-size, original images. This option prevents anyone other than the photo’s owner to download the full-size image.

It defaults to enabled.

Prevent hot-linking to images

Hot-linking is when another site links directly to the images hosted on your own website. Enable this option to attempt to prevent hot-linking by checking that the “referrer” header is set to a page on your Blue Twilight application.

This is only a “best estimate” protection as the referrer header can be easily spoofed by a client application, and may not be supported by all browsers.


Enable built-in visitor hit tracking

To collect “hits” against photos and albums in the Blue Twilight database, enable this tick box. This will reporting on the most popular albums and photos in the future (this isn’t currently a feature.)

External analytics

If you use a service such as Google Analytics or Piwik to analyse your visitor activity, you can copy and paste the Javascript tracking code provided by these services into this text box, and it will be rendered in the footer of every page – allowing you to analyse your visitor activity.

Please note: copy the script exactly from your service provider – including the <script> tags!


If you are based in Europe and you enable visitor tracking, you will need to comply with the EU Cookie Law. The easiest way to do so is using a script like Cookie Consent by Insites.

You can add Javascript like that provided by Cookie Consent into the “external analytics” box, in addition to any other Javascript code you add, such as Google Analytics.

Information about the EU Cookie Law directive
Cookie Consent by Insites