Elgg example theme framework v1.0

Release Notes

This theme is an example theme framework that can be used as a starting point for your own theme work. It requires Elgg version 1.5.

example themeIt includes overrides for all the graphics (default avatars, group icons, river icons, file type icons, widget-picker icons, friends-picker arrows, owner-block icons, avatar menu arrows, etc.).

It also includes css overrides for all the Elgg full-package plugins (blog, categories, custom_index, external pages, file, groups, members, notifications, profile, thewire, twitter etc.).

Once unzipped and copied to your /mod directory, log-in as Admin, go to Tool Administration, and use the controls to move the theme plugin to the bottom of the plugin list (so that it loads last). Making a change to the plugin list order will force the sites cache to be updated - so the new theme is displayed (or you can run upgrade.php to rebuild the sites cache).

If you are looking for a guide on how to upgrade your existing custom theme to v1.5 have a look at this documentation.

  • @Yannick.. It may be working but the site cache is reloading.. Every time you modify CSS files, you will need to reload the chache.. Edit your css, then go to your site admin, untick the 'use simple cache, save, then tick the same checkbox again and save again and that should pick the new view style. In addition, make sure you declare the reference to your image correctly in the css.

    @Pegasus.. The read me file in this plugin contains some information to do that. All you have to do is upload your site logo (image) to replace the elgg image.. Make sure you use the same file name for your site image as the one used by elgg.. this will save you modifying css and header content files.



  • @pete awesome work!

    I startet to create my own theme base on this one right after I downloaded it and directly run into the first problem ^^. I want to use css sprites for example for the river icons. the problem is that i do know the css file that i've got to change but do not know where the css class is called because i would need to change things there too. Hope some one can help me thx!

  • some class are defined in main css in your elgg instalation  public_html/views/default/css.php 

    i think that elgg load river class from there if curent theme doesn't establish it.

    but its only my thinking


  • public_html/views/default/css.php

    rivers' class config  starts in line 1134

  • theme_elgg_example/views/deflault/css.php

    line: 1148

    /* ***************************************
    *************************************** */

  • After running upgrade.php while theme_elgg_example is enabled and at the bottom of the the Tool Administration list, default user images (defaultlarge.gif, defaultmedium.gif, etc) aswell as example_theme_logo.gif no longer appear. Disabling theme_elgg_example causes them to reappear again.

    I'm fairly new to CSS so I figured it might have been something *I* did wrong while mucking around, but was able to replicate the problem with a clean version of the plug. What would be the proper workaround/solution to this problem, if there is one? Any help is appreciated!

  • Hello All

    I have a problem here I cannot get in to the administration panel after I accidently turned on a plugin that was not finished ant ideas how to get the admin panel back?

    Thank you


  • Fixed the problem. This template is great thank you for sharing it.

  • Pete you are the best! I just started using elgg not long ago and I am learning so much because of this template. I wanted to add a screen shot but can't get it up for some reason. I was wondering if you mind if I update a few themes to work with elgg1.5 or atleast make an attempt at it.


    again thank you


  • This is great!  How can I change the locations of the login box,bookmarks, files ect. on the front page.  I prefer the front page layout of the natural_brown theme (login on the left) and would like to make the theme_elgg_example match this layout.

  • sasafras: You have to use custom_index module

    it looks like on my site

    You can download this module here


  • Pete:

    This is a great template to learn from, thanks for the help. Just one question, what is the area called that has the elgg image (Example_theme_logo I believe) in it. Where would I go to change the height of this section?


  • i installed it on 1.6.1 .. works so far.  Pete, any known issues with 1.6.1?

  • To use it with 1.6.1, edit page_element/header.php and change the link to the good jquery ref (jquery version has been upgraded in 1.6.1).

  • @pivey and nicpan: even better delete page_element/header.php and the js directory with its two files. Those normally shouldn't be included in a theme.

  • Thanks, good to know.

    But what if i want to include in the head my own js lib (jquery tools for example, or other jquery utilities not included in the core or elgg package) ?

  • I have upgraded my Elgg installation to 1.6.1 and then tried to use the theme_elgg_example to build a customized theme.  Now I am getting an error "$els.sortable is not a function" on line 51 of /_css/js.php/1257368461?js=initialise_elgg&viewtype=default.  As a result of the error (or coincidental with it) the widgets never populate.  When I disable the theme, then the widgets work.  I have tried both nicpan's and Cash's suggestions without success.  Any ideas?

    Any assistance would be greatly appreciated.

  • What am I missing? What did i do wrong?


    Hi Folks,

    Just installed Elgg, installed and enabled this theme, now some of the original features are missing and frankly i am unable to explore all the features of this theme that everyone is raving about. Searched thru all your comments and didnt see any related to this problem. If i missed something, i apologize. Can anyone tell me how to get this theme working properly?

  • Great theme! I was wondering how to change the title description. Right now it reads "Site Name: the page title". The site name is correct however, I would like to change the text that reads "the page title". Not sure if this is a theme thing or something else. 


  • Just downloaded this theme and it's updated not long ago I see. But it doesn't work for me.

    I have moved it to the buttom and when I activate the plugin, the messagebox that tells the plugin is installed don't fade out, and in the top menu the tools buttons are inactive.

    What have I done wrong here? Can it be that I am testing on localhost?

  • Are this theme is compatible with elgg v1.7?


  • Category: Themes
  • License: GNU General Public License (GPL) version 2
  • Updated: 2014-11-17
  • Downloads: 10261
  • Recommendations: 3

Other Projects

View Pete Harris's plugins