customstyle 1.1 (elgg 1.7) v1.1

Release Notes


Gives users the possibility to customize the look and feel of their profile pages. 



- Change background image (default or uploaded)

- Change background layout (position,repeat, fixed/scroll)

- Change a number of colors (background, widget background, header, fonts etc)

- Live Preview when changing colors and background

- River events on update of profile style


If you need to change the colors that can be configured (and know a little php), check out the views/default/customstyle/colors.php file. In it you will find an array of all the elements that can be configured by the user. Delete entries or add as you see fit.


Version History

1.1     - works with 1.7.1 elgg

- added backgrounds from Chella and Jag with attribution on the page

- added numerous other backgrounds of varying quality with high-res copies available on request (30 additional megs with them)

- updates for deprecated functions and misc changes

1.0 RC3:

- some css adjustments

- fixed: loading of js files in colorconfig

1.0 RC2:

- added: dutch language file

- fixed: blank pages on some pages (page_owner was 0)

- fixed: palette icon not showing

1.0 RC1:

- added: river event when changing style (option in admin tool setting)

- added: option for enable/disable custom background upload (admin tool setting)

- added: option for configuration of max uploadable image size

- added: customstyle now saved as object instead of metastring

- added: lightbox preview of backgroundimages

- added: thumbnail creation on upload custom background (small performance issue)

- added: !important flags on background properties

- added: some extra default seamless backgrounds (all free to use), removed metal background (wasn't seamless)

- fixed: font color previews

- fixed: "reset to normal design" not working in Safari/Chrome

- fixed: Background filesize limit not handled (cant upload, but no error message)

- removed: saving of customstyle as metastring (you need to reconfigure your style when upgrading from previous version)

- new version jscolor 1.2.3 included

- included lightbox js (packed only 7k!)


- added: admin setting to allow/disallow customstyle for background and/or colors

- added: "show in normal design" when customstylesheet is loaded. Allows switching to default style if customstyle is a little too artistic :)

- added: some extra default seamless backgrounds (all free to use), the ducks are sweet

- fixed: remembers previously uploaded background (didn't show when it was not the current)


- First release to the public


- color management

- Use images uploaded in files and tidypic as background

- Create color presets (red style, green style etc) -> sets all colors

- enable sharing of personal theme (allows copying theme to own profile)

TO INSTALL: unzip to mod/ directory and enable.  


  • Great Plugin. Users love the ability to change the way their profile etc looks.
    However, like STONEwebBiz, the upload of background images does not work for me.

  • What versions of elgg are you using with the issues with background?

    might check permissions of your data/ directory as that would be the only issue i can think of.

  • Hi. I'm using elgg 1.7.1.
    The permissions of the data folder seem OK as izap vids & tidypics accept uploads.

    I am now told that the upload was successful, but end up with a blank (white) background and the current image (my own background) shows a red cross

  • Working purfectly here ! in profile and groups elgg 171

  • I am getting same problem with groups


    You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near 'and e.site_guid = 1 and e.container_guid = 37 and ( (1 = 1) and e.enabled='ye' at line 1

    QUERY: SELECT * from elgg_entities e join elgg_objects_entity o on e.guid=o.guid where e.type='object' and e.subtype= and e.site_guid = 1 and e.container_guid = 37 and ( (1 = 1) and e.enabled='yes') order by e.time_created desc limit 0, 1

    is there a fix for this

    Im using 1.7.1

  • Regarding above the problem,

    After opening and save, group works fine .

    It occurs at line 70 in start.php (get_custom_style_from_metadata function).

    the function is called at views/default/customstyle/metatags.php


    >$currentConfig = get_custom_style_from_metadata(page_owner(), 'customstylecolors');

    I think , it will be fixed for  saving default configration as user custom config initially


  • I fixed the SQL error problem.

    patch is here:

    to install

    %cd mod/customstyle
    %  unzip

    inflating: views/default/customstyle/metatags.php

    this patch only overwrites views/default/customstyle/metatags.php.


  • @takeshi yes it fix the problem to open groups after activating custom style plugin but getting problem to save the backgrounds and colors. by the way thanks to sort out this problem


  • any way of adding a paginate function for the backgrounds, just to help with slower connections, less wait etc, or better yet categories

  • Hi,
    My uploaded backgrounds still do not save.

    The customize your own background screen shows a red X next ro current image and a red X next to previously uploaded.

    If I click on the current image, a page tries to load "mod/customstyle/getbackground?id=2"
    but returns a 404 error.

    If previous image is clicked, the lightbox appears, but does not load anything.

    Do I need to change where the pictures are uploaded to ?


  • the background images save to the user's data directory, but do not display anywhere they are required to do so by the plugin script.

  • This plugin is not cause an Error on Elgg 1.7.2 at the Group

    This is the error

    Fatal error: Exception thrown without a stack frame in Unknown on line 0

    How can fix this???

    Thank you..


  • Fixes posted are in the new version i am developing on 1.8-svn now, so I don't know how much help I can be with 1.7.

    The background images are saved like any other File into the data directory, if you could take a look at your logs and post any errors I might be able to help.

  • The error does not appear again when im upgrade it to Elgg 1.7.3

    Btw since im using it on the Elgg 1.7.1 im can't upload my own background, it just appear red X cross same problem with elggfan

    How can i fix it?

    Thank you..

  • Hello
    This version, 1.7.6 works fine in elgg?
    change the substance of the "calendar of events " and "groups"?


  • Hi,

    I had this excellent plugin working great for the last week or so, then it stopped. I can get into the change color page and get no errors but the colors no longer change. I get a 'successfully saved your colors' message but no change. Also there's no longer a link on the dashboard or profile page. I've tried installing again but that hasn't fixed anything.

    A test user I created still has the link and the plugin is still working for him but not for any newly created users.

    Are there any known conflicts with any of the following plugins?






























    fusion pack












    Invite friends

    Any ideas?



  • I've just installed customstyle on a clean install of 1.7.1 and it's not working for me.

  • I dont know about themer being compatible but all others you have listed should work fine, check the permissions on the data files since you said it worked for older users.

  • Hi Bman, I checked my permissions for my default data folder, they're 777, recurse to subfolders.

  • Try moving the plugin to the bottom of the plugins list and see if that helps

  • I've tried re-positioning, re-installing and disabling themer. Also it's not working on a fresh install with new db etc.

    Wierd, as I had it working really well before.

  • Got it, I replaced view.php in simplecache with an older version and it now works again.

  • I use the theme 666 by alan. And this plugin is not work. The background is not view. How fix that?? Please help me

  • Do you plan to upgrade this mod to  I really like it and would like to have it again on the new version.  Thanks so much!!

  • I started to update this plugin to version 1.8 of elgg! Coming soon!


  • Category: Tools
  • License: GNU General Public License (GPL) version 2
  • Updated: 2014-11-17
  • Downloads: 3533
  • Recommendations: 6

Other Projects

View bman's plugins