BEgallery extension for BlogEngine.net

About BEgallery

BEgallery is THE gallery extension for Blogengine.net. It integrates the excellent Highslide JS thumbnail viewer, by Torstein Hønsi, seamless in Blogengine.net.

Why another gallery extension you would ask? Well most of the available solutions are terrible when you look at the design aspect or simply died on the way.


Left: gallery view generated on the blog posting. Right: popup view of a selected photo. Other parts of the site are grayed out.


Why use Begallery?

  • Seamless integration
  • Fully configurable;
  • Best looking (on a design aspect);
  • Easy install;
  • And best of all, it's free*

  • Example

    See Begallery in action? Check out this live example!


    Download

    Download the BEgallery package and follow the installation instructions below.

     BEgallery.v10.zip (91,87 kb)

    BEgallery is licensed. Check the end of the page for the restrictions and how to use in your own developments.


    Installation

    To install BEgallery on your BlogEngine.net follow the steps below: 

  • Copy the BEgallery directory to the root of your BlogEngine website; 
     
  • Copy the BEgallery_admin directory to the admin directory of your BlogEngine website; 
     
  • Copy the Begallery.cs file to the extensions directory of your BlogEngine (this is the app_code/extensions directory).
  •  

    This concludes the copy part. Now we need to change some rights and add the admin module to the menu bar.

  • Change the rights on the gallery_files directory (located in your BEgallery directory). Add the ASPNET user and give it change rights.
  •  

    (Note. On some systems you need to add the Network Services account and give it change rights. This depends on which user or account you BlogEngine is running.)

  • Locate the web.sitemap file in the root directory of your BlogEngine. Add the following line of code to the end of the file.
  •  

    < siteMapNode url="~/admin/BEgallery_admin/default.aspx" title="BEgallery" description="" roles="administrators,editors" />

    Your ready to go. See the next session on how to create and maintain a gallery.


    How to Use

    Configuration

    You can configure some basis settings of BEgallery through the extensions tab in the control panel. Locate the BEgallery extension and click the edit link.

    There are three options to set: Skin type, image width and thumbnail width. For skin type there are two options: Dark and White (default). The width of the normal image is the width of the popup version of the image. The width must be supplied in pixels. The thumbnail width is the size of the gallery thumbnail shown on the page.
    Note: the size of portrait images is calculated automatically based on the widths.

     

    Administration

    After installation there is a new option in the control panel menubar. With this BEgallery option you can manage your gallery’s. There are two sections: Gallery’s and photo’s. The first let you create, view and remove a gallery.

    After selecting a gallery you can manage the content using the second part of the screen. Here you can upload and remove a photo. The photo’s you upload are automatically sized to the dimensions entered in the configuration screen of the extension.

    Note: Do you have problems with uploading photos? check this hotfix

     

    Page referrer

    To activate a BEgallery in your page, you need to add a BEgallery tag to you page and supply the gallery name to display. The tag location in the page will be replaced by the gallery.

    This is an example on how to add a gallery named New York

    [begallery:newyork]

    When you supply an unknown gallery, a error message will be placed on the page.


    Licence

    *) BEgallery is licensed under a Creative Commons Attribution-NonCommercial 3.0 License. This means you need the author's permission to use BEgallery on commercial websites.

    Redistribution

    You are allowed to distribute BEgallery with non-commercial packages given that you fulfill two conditions:

  • Emphasize to your users that BEgallery is not free for commercial use. You can do this on your download page or when your users activate BEgallery in your application.
  • Provide a link back to this web page in the same location.
  •