How to set a custom login page background image in 5.7.5+

This is a community-contributed tutorial. This tutorial is over a year old and may not apply to your version of Concrete CMS.
Jul 12, 2015

In Concrete CMS 5.7.5+, you can add a custom background to the login page. This custom background image will replace the photo of the day default.

In your application\config folder, open concrete.php. If you don't have a concrete.php file, you will need to create one. The concrete.php file will only contain PHP, so only an opening PHP tag is required. Paste the following code into concrete.php.

<?php
return array(
    'urls' => array(
        'background_url' => 'http://example.com/example_background.jpg',
    ),
    'white_label' => array(
        'background_url' => 'http://example.com/example_background.jpg',
    )
);

If concrete.php exists and already has arrays of configuration settings. Add a comma after the last first level sub-array (not the returned array) and then paste the background image configuration settings after the comma.

Example: existing array

<?php
return array(
    'marketplace' => array(
        'enabled' => false
    ),
    'external' => array(
        'news_overlay' => false,
        'news' => false,
    )
);

-- external in the above example is the last first level sub-array

Example: background image configuration settings

'urls' => array(
    'background_url' => 'http://example.com/example_background.jpg',
),
'white_label' => array(
    'background_url' => 'http://example.com/example_background.jpg',
)

Example: adding to the existing array

<?php
return array(
    'marketplace' => array(
        'enabled' => false
    ),
    'external' => array(
        'news_overlay' => false,
        'news' => false,
    ),
    'urls' => array(
        'background_url' => 'http://example.com/example_background.jpg',
    ),
    'white_label' => array(
        'background_url' => 'http://example.com/example_background.jpg',
    )
);

The background_url key has a string value that is the URL of the background image. To support 5.7.5+ and v8, the same URL is used for both the urls and white_label arrays.

The background image path can be absolute or relative from your site root or the concrete file system.

Example: getting an image url from the concrete5 file system

  • open the file manager - Dashboard > Files > File Manager
  • click on an image to trigger a popup menu
  • select Properties from the menu
  • copy the value of URL to File
Recent Tutorials
How To Exclude Subpages from Navigation
Dec 24, 2022

How to exclude subpages from navigation - useful for a news or blog link in your main navigation where you don't want all the subpages to appear in a drop down menu.

How Can I Change The Maximum Size Of Uploaded files
Dec 13, 2022

This tutorial explains how to update your php settings.

Updating Concrete Themes from Version 8 to Version 9
Nov 24, 2022

This tutorial covers commonly encountered issues when upgrading a Concrete CMS theme from version 8 to version 9

Transferring ownership of an add-on and a theme
Nov 15, 2022
By katzueno.

If you encounter a Concrete CMS add-on or theme that you love but not being maintained, you may want to ask the author to help or take over the add-on or theme. Here is the quick step-by-step guide of how to transfer the ownership.

How to update Add-Ons if not on the Update Add-Ons Menu item
Jul 4, 2022

How to manually download an add-on and update it when your site's core versions isn't considered compatible with the add-on version.

Generate a report with author information and form summaries in Concrete CMS.
May 9, 2022

In Concrete CMS, you can use a form to initiate contact between logged-in users and then create helpful reports. After form submissions are collected, they can be searched, sorted, and exported as a spreadsheet. This tutorial will detail how to add author information to a report using the advanced search.

Was this information useful?
Thank you for your feedback.