Skip to content

r7-labs/R7.Epsilon

Repository files navigation

About R7.Epsilon

BCH compliance Join the chat at https://gitter.im/roman-yagodin/R7.Epsilon

R7.Epsilon is an opensource responsive skin (theme) for DNN Platform based on Bootstrap 4. See it in action at http://www.volgau.com!

Features

  • Website-specific configuration via YAML files.
  • All menus are fully keyboard-accessible!
  • A11y tools like theme and font size changing, disabling DNN popups, "jump to content" link.
  • Many skin variants, reusable through all portals.
  • Block-based skin structure, reusable layouts across different skins.
  • Variety of containers, including DNN-style messages, Bootstrap alerts, cards, callouts, etc.
  • Social group icons for Facebook, Twitter, Google+, YouTube, VK.com, Instagram, Linkedin.
  • Social share buttons for Facebook, Twitter, Google+, VK.com.
  • Completely localizable parts (full Russian translation included).
  • Website-wide and host-wide static content customization via resource files.
  • Integration with feedback forms including passing user-selected content.
  • Google Adsense adaptive banners support for different screen sizes with automatic loading on window resize.
  • Basic Blueimp Gallery support.
  • Cookie consent, "cookie disabled" and "browser unsupported" alerts.
  • Improved partial content behaviour (with ?mid=<ModuleID>).
  • Alerts for admins about unpublished pages.
  • Optional cnt.sputnik.ru analytics support.

Site-specific (portal level) custom skins

With R7.Epsilon, you can create custom skins/layouts based on stock ones, adopted and available for specific website only:

  1. Copy selected skin files (e.g. Home.ascx) and corresponding layout files (Layouts/_home.ascx) from ~/Portals/_default/Skins/R7.Epsilon host skin folder to the ~/Portals/X-System/Skins/R7.Epsilon folder (or ~/Portals/X/Skins/R7.Epsilon folder), there X is a portal number for your website.
  2. Copy also skin.doctype.xml to set proper HTML Doctype, or make sure that Fallback Theme Doctype in Host settings is set to HTML5.
  3. Now, if you just want to change panes layout, you can do that by editing layout file contents.
  4. Select your custom skin from Appearance tab in Page Settings. It will be something like Site: R7.Epsilon - Home.

Do not copy entire ~/Portals/_default/Skins/R7.Epsilon folder - your site-specific skins will still reference JS, CSS, images and will use localization resources from host skin folder.

Note that layout files are reusable - any number of skin files could reference single layout file. So it's probably better to make a copy of layout file and reference it in your custom skin if you planning to do any changes.

Note also then you update R7.Epsilon package, there is a chance that some things in your custom skin will break. Please always test updates in non-production environment first!

Install

Install dependencies first:

After that, install latest R7.Epsilon version from releases.

Note that though you can use R7.Epsilon for Admin/Host pages, we strongly recommend to use one of the pre-installed DNN themes for that - just to be sure that you will always have access to Admin/Host pages.

Disable menu caching

For relatively small sites, it make sense to disable menu caching completely.

To do so, remove the OutputCache directives from PrimaryMenu.ascx, SecondaryMenu.ascx and BreadcrumbMenu.ascx files in the ~/Portals/_default/Skins/R7.Epsilon/SkinObjects folder.

Enable menu caching

For sites with large number of pages it generally make sense to use cached menus.

In order to enable menu caching, extract the Globals.asax file from release .zip package and place in the the DNN install root folder - remember to backup the original version of this file first!

Basic blueimp Gallery support

Each static image with data-gallery="" attribute on the enclosing A tag will be displayed in "each own" lightbox:

<a href="/images/orange.jpg" title="Image of orange in the default gallery" data-gallery="">
    <img src="/images/thumbnails/orange.jpg" alt="Orange" />
</a>
<a href="/images/peach.jpg" title="Image of peach in the default gallery" data-gallery="">
    <img src="/images/thumbnails/peach.jpg" alt="Peach" />
</a>

Of cause, you can also have any number of additional lightboxes (galleries, carousels) on the page, but you'll need to add lightboxes markup for them manually. See more in the blueimp Gallery readme.

License

AGPLv3

The R7.Epsilon is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

License for assets

Social icons based on Stephen Hutchings's Typicons, published under the terms of CC BY-CA license.

Google translate and A11y icons based on Xaviju's Inkscape Open Symbols, the source of which is published under GPLv2 license.

Palettes for color themes created with Paletton.com.

Customization

As you should already know, any website skin is more like a template which should be customized (sometimes very heavily) before using it in production. The R7.Epsilon skin developed with per-DNN-portal reuse, configuration and customization in mind, so (hopefully) you can configure and customize it for your website pretty fast.

Some links to allow you to get started: