Set up your site

From e107 Wiki
(Redirected from HOWTO:Set up your site)
Jump to: navigation, search

e107 Wiki: English | Русский | Deutsch | Français | Magyar | Português | Български | Česky | Nederlands | Ελληνικά | Italiano | Norske | Polska | Slovenščina | Español | Svenska | Translate: Wiki | Page


Current Release 1.0.4 | | Download | Changelog | Forum | Plugins | Themes | RSS Feed of Latest Changes | Atom Feed of Latest Changes

How to setup your site after a fresh install
Main page > I : First Aid > II : Development > III : Administration > IV : How To's > V : Plugin Writing > VI : Theming & Shortcodes

This page is a stub. You can help e107 by expanding it.

Setting up your new e107 Website

At this stage you have just installed your e107 Content Management System.

This page gives some pointers on areas to configure. It is intended as a very brief overview - many of the topics are described in more detail elsewhere. All these descriptions assume that you are logged in as a main admin, and starting from the main administration screen. It is well worth exploring all the admin options to get a feel for what is possible with the standard installation. The best time to experiment is when the site is new!


Many general options and preferences are set in here. Some of the ones that you will want to change straight away are:-

Site Preferences in Detail: Using_e107:Settings:Preferences

Meta Tags

With this tool you can add, change and remove Meta elements very easily. Mainly used because of SEO.

See Using e107:Settings:Meta Tags

Welcome Message

You can set a welcome message for your site visitors. A different message can be set for each of your main types of visitors; which in e107 are guests, everyone, members (or users), custom user classes and Administrators.

The welcome message is shown at the top of your front page. Setting your Front Page to Welcome Message avoids a page re-direction which can be problematic for SEO, and hence this is probably the best page to use for your home page or landing page.

Site and Admin Themes

Themes determine the appearance of your e107 website, and may be previewed and selected through the Theme Manager. Themes determine the general layout of your pages. The theme defines areas where menus can be placed. You can select different themes for the 'public' areas and the admin area of the site.

The default theme for Admin is called Jayya and this is specifically designed for Admin. It is recommended that you keep Jayya as the admin theme. When troubleshooting you will be advised to set the admin theme back to Jayya.

Some themes have display options, different style sheets and so on, selectable through the Theme Manager. And some themes have optional multi-column layouts which may be enabled.

Later on you may wish to obtain a theme from elsewhere, or modify or code one yourself. When modifying a theme, avoid changing the supplied themes, as these changes will be overwritten at upgrade. Instead copy to a new folder for your customised version.

  • Theming - Wiki pages explaining theme creation.
  • Download e107 themes for your site .
Note that themes written by third parties are not guaranteed to work with newer releases of e107. 
They are supported by the Theme designer in the first instance.

Custom Menus/Pages

Create your main web page content using custom pages. These are used for essentially 'static' content. For example, a typical site may require an About Us page, you can easily create a new page and a site link for for the page in one simple screen. Note that you can control which menus are displayed on a specific page through the Menu Manager. For those who may be interested in having a different theme for a particular page, there is a third party plugin called Custom Theme.

Menus are similar to pages except that a Custom Menu may be placed in a specific menu area on the screen, while Custom Pages appear within the 'main' area. Custom pages may be individually password protected, and/or be visible to a specific user class only.

For large amounts of content, consider the more powerful Content Management plugin, which provides a lot of flexibility. For the more adventurous, you can have even more page control by creating a standalone custom php page, which is fully supported by e107. This is very useful for SEO, it means you can have pages which contain keywords in the file name and therefore the URL.

Front Page

The Front Page Manager allows you to set a 'Home' page for your guests visitors, members, user classes and administrators; it can be set by user class. Most e107 users use the news page as their front page.

Note that, as mentioned above, if SEO is important to your site, setting Front Page to Welcome Message.

When 2.0 is released, it will also allow you to control the first page users are shown after login; see Admin:Front_Page

Site Links

Site Links build the 'main menu' for your e107 website. You can enter new site links via Admin area > Settings > Site Links. The style and layout of your links is defined in your theme. The visibility of each link may be assigned to a particular user class, and the order of the links controlled. Site links can be displayed as a menu, this menu is called Tree Menu found in the menu manager. Depending on the theme design, the default main menu may become hidden when tree is activated (i.e. you only see one instance of the main menu).

(Note that the visibility setting only controls display of the link. Access to each page is controlled separately through other menus, otherwise if a visitor knows the correct URL, they can still access the page).


Plugins add functionality to your site. There are a number of Core Plugins which are delivered as standard with every e107 installation. Generally they are all uninstalled. To view the list of core plugins, go to Admin Area > Plugins > Plugin Manager, and you are shown a list of available plugins, it shows those which are installed and those which require installation via the install button. You can select and install the plugins for the functions you need; they can then be configured through the plugins area of the admin screen.

Additional plugins can be obtained from a variety of sources, and it is quite possible to create one yourself. See these sites which hold a library of plugins created for e107 users.

See also Wiki pages about writing your own plugin for e107.

Page Layouts

You set the layout of each page using the menu option (within the constraints set by the selected theme). In the simplest case, the layout of all pages is the same. It's possible to modify the layout on selected pages within the theme files.


Your e107 website provides an extensive user or member management system. Go to Admin Area > Users Users Menu. Under this menu you have a number of options to control your site membership.

  • Set Main Admin's password.
  • You can control other Administrators Permissions
    • Note that you do have to go to the user account first and choose 'Make Admin'.
  • You can Ban users/IP's/email addresses using Banlist.
  • To collect extra user details, define Extended User Fields, City or Skype name for example.
  • Mail option allows you to send mailshots to individual or groups of users
  • You can place users into groups using User Classes
  • Finally, the main Users menu option allows you to manually add new users via Quick Add User.
  • To enable or disable user self registration see User Preferences.

Cookies or Sessions

User Tracking Method needs to be set. Generally people prefer cookies, change the default cookie name to something which is likely to be unique for your site name such as mysitename_e107cookie.

Cookies = Technically, cookies are arbitrary pieces of data chosen by the Web server and sent to the browser. The browser returns them unchanged to the server, introducing a state (memory of previous events) into otherwise stateless HTTP transactions. Without cookies, each retrieval of a Web page or component of a Web page is an isolated event, mostly unrelated to all other views of the pages of the same site. By returning a cookie to a web server, the browser provides the server a means of connecting the current page view with prior page views.

according to

A session is either a lasting connection using the session layer of a network protocol or a lasting connection between a user (or user agent) and a peer, typically a server, usually involving the exchange of many packets between the user's computer and the server.

according to

Anyway, a cookie is stored on a users hard drive and can be re-used by the Internet browser. A session is just a temporary data storage in the memory of the browser.

So, if you want users to be prompted with their own login id and password the next time they visit your website after closing of their browser; choose cookies.


The e107 website system contains an easy to use news management system. Go to Admin Area > Content > News > News Preferences to control the way you want the News system to behave. From the other menu options you can see where you can set up additional categories. The news system will work 'out-of-the-box'. You can post news to your news main page or to the 'other news' menus. Choose the render-type to determine where it is displayed. (You have the main news area, plus two 'other news' areas). If you want your users to be able to submit news, you can place use a Site Link to the submit news page, we recommend you keep this to at least members only to avoid content spam.

Some people would like news to have multi-level categories, in this case, we suggest you consider Content Management which has much more powerful features.

Removing "Welcome to e107"

  • By default the first news item in e107 is populated with "Welcome to e107"
    • To remove this item, do this:
      • Admin Area > Content > News
      • Locate News Item 1.
      • Click the red cross to delete it.


Edit settings for images on your e107 site, including:

  • Enable image display
  • Image display class
  • Disabled image method
  • Resize method
  • Path to ImageMagick (if selected)
  • Enable Sleight
  • Show uploaded avatars
  • Validate avatar size and access


Use this screen to enable/disable use of emoticons, and select which 'pack' is active.


Usually used to advertise other sites, this feature allows you to create and manage Banner ads for sites on a percentage basis - so one is displayed, for example, 60% of the time, while another banner is only displayed for 40%.

Cache Control

The e107 Cache System is used for reducing calls to you database, which should help minimise your bandwidth usage. If caching is enabled, many of the pages of your site will be stored as files on disc. The contents of these files are displayed to users, rather than the page being generated each time - this speeds up the response, and reduces the load on the server. Files are generally refreshed automatically as content changes.

It is advisable not to enable the cache whilst you are still building or changing major elements of your site. For example, when installing Languages, the cache can prevent you from seeing the new language (equally true for your browser cache). Hence you probably should avoid enabling the cache until you have completed building your site.


Notify controls the function to email site members and administrators when certain events occur, such as sign up and login.


Go To Admin Area > Users > Mail to send mailshots to website members and under the options you can configure the general mail properties which e107 uses for various purposes. In general this works out-of-the-box, and hence very little needs to be changed.


You may want to allow web site visitors to download files you have made available via Public Uploads. Go to Admin Area > Content > Downloads to set up the structure of the download area, and manage the associated files.

Public Uploads

With this tool you can configure your Public Upload settings on your e107 site. Also you can view what was uploaded with the upload.php page and edit or remove items. Go to Admin Area > Content > Public Uploads to maintain this area.


This is used to configure search settings like who you want to search in which category. It also includes search preferences that give more configuration to your search tools with e107. Go to Admin Area > Setting > Search.


Allows you to ban people, show existing bans, edit existing bans and remove existing bans. This is the manual way to ban people in e107. If people are banned from your site via e107 they will show up here. (The banlist uses IP addresses and, if enabled, domain names to determine of someone is banned. Individual E107 users can be banned by user name through Admin-->users).

See: Banlist

File Manager

Provides access to manage and upload files to the 'public' file areas.

See: File Manager


Allows you to take your site off-line, with visitors being given a 'maintenance in progress' screen (you can control the message). If you as administrator log out while the Maintenance plug-in is active, you can only log back in directly to your admin page. Since some users change the name of their admin folder for security purposes, make sure you know the complete URL to that page.

See: Maintenance Flag

File Inspector

Allows you to check that all files have been uploaded properly relative to your version of e107. If you edit files like themes, use files from CVS, add plugins or any other changes/additions you will get errors, this only means that it is not the same as your current e107 install. It is good to check this if when updating or installing files, sometimes you can get corrupted or missing files.

See: File Inspector


Provides various functions for upgrading, verifying and organising the database.

See: Database

Setup Your Error Pages

You can use the nicely formatted e107 Error Pages, rather than the standard ones provided by your host.

See: Error Handling Pages