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

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 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.

How to clone and customize Atomik theme
Feb 14, 2022
By linuxoid.

How to clone and customize Atomik theme

Update jQuery to 3.5 on Concrete CMS version 8.5.x
Dec 1, 2021
By hissy.

If you have to take some time to fix your site to work with version 9 and want to update jQuery immediately, you can override it.

Add-On Developers: Get Your Add-Ons Ready for Concrete CMS 9.0
Aug 6, 2021
By andrew.

Concrete CMS 9.0 is coming! But there are some changes in version 9 that might affected your add-ons and themes. This document aims to answer questions about the most common ways that your add-ons might need to be changed, and common problems you'll run into.

Permissions for editors in a multilingual site
Jun 2, 2021
By myq.

How to set up a multilingual Concrete CMS site for groups of language-specific editors

Was this information useful?
Thank you for your feedback.