Bookshop

NOTE: We’ve developed a native UB Bookshop theme for Magento 2. Check out the userguide for UB Bookshop here.

Responsive Magento theme Bookshop is a professional makeover for any ecommercial bookstores! Bookshop features up to 9 complementary Magento extensions including Mega Menu, Masshead, Slideshow 2, Product Slider, Tabs, Product along with Quickview. Also the Mangento theme is fully responsive and supports Off-canvas navigation.

This documentation is to guide you about how to install and configure the responsive Magento theme Bookshop to your own website.

Once downloaded Bookshop, you will get a zipped file including the following folders:

  • mage_ext: contains all built-in extensions of the theme.
  • mage_tpl: contains the theme files only.
  • quickstart: a full Magento CMS version with our theme already integrated to match the demo.
  • source: contains all source files of the theme.

Unzip the file. Please be noted that there are two ways to install a Magento theme:

  • General Installation: Applicable when you have installed a Magento base on your server before.
  • Quickstart Installation: Applicable for our Magento users. With Quickstart, you will get a site just as the same as our Demo site.

We are going through each way of installation in advance of more further configurations.

In case you have installed the Magento base already, this way of installation will help you to adapt the theme and extensions of Bookshop to fit your current site. Let’s see how to install the theme and its extensions respectively.

1. Theme Installation

Please make sure your Magento store is ready before you integrate Bookshop. If your store has not been available yet, get it done quickly by following the Magento Installation Guide.


Extension basetheme is required to be installed before installing the other extensions and theme.

The installation of Bookshop is quite simple with several following steps:

1. Upload the folders skin and app from our download package to your Web server’s document root (from here on, referenced as {docroot}.

2. Unzip “Bookshop” package. Next, copy the two folders skins and app to the root of your Magento site folder on the server. Accordingly, the folders will be overwritten and you should see a directory layout like this:
{docroot} /magento/app/
index.php
js/
lib/
LICENSE.txt
media/
pear/
skin/
var/.

3. Open the Admin Panel of your store, and access Magento Admin area on a stage localhost: https://localhost/magento/index.php/admin/, then log in your Magento Admin area.

4. Navigate to System >> Configuration >> Design. Simply replace the original name e.g. jm_purity with jm_bookshop.

5. Fill “jm_bookshop” into the Themes folder.

6. You can also change the settings for Bookshop Header.

7. Click the button “Save Config” to save your configuration.

You are done! Bookshop is now ready to go!

2. Extension Installation

To install the built-in extensions of Bookshop, please follow steps as below.

  • Upload folders skin and app from our download package to your Web server’s document root (from here on, referenced as {docroot}). These files will overwrite default folders skin and app in your Magento folder. Thus, you should see a directory layout like this: {docroot} /magento/app/
    index.php
    js/
    lib/
    LICENSE.txt
    media/
    pear/
    skin/
    var/.
  • Log into your Magento Admin area (i.e. access Magento Admin area on localhost: https://localhost/magento/index.php/admin/).
  • Navigate to System >> Configuration.
  • The installed extensions will show off. To enter the extension configuration page, click the extension’s name tab.

3. Create Static Blocks

  • Go to Magento Admin Panel >> CMS >> Static Blocks.
  • Click “Add new Block” button.
  • Fill in all fields as below then click “Save Block” button:
    • Title: Right module
    • Identifier: right_block
    • Store View: All Store Views
    • Status: Enable
    • Content: fill in all syntax quoted as you would like.
  • To edit the existing static blocks, go to CMS >> Pages and then select the page in which blocks you want to edit.

  • In General Information tab, fill in the Content field with syntax quoted.
  • To display a new static block, copy and paste the following code in the “Layout Update XML” field in “Design” tab.
    <html>
    <reference name="right"> 
    <block type="cms/block" name="jmtabs" before="-">
    <action method="staticblock">
    <title><strong><COLOR=Red>New block</COLOR></strong></title>
    <identifier><strong><COLOR=Red>new_block</COLOR></strong></identifier>
    </action>
    </block>
    </reference>
    </html>
    

Clear cache if needed (in System >> Cache Management >> Save cache settings). Refresh your Homepage to see the change applied.

Quickstart package is to minimize time and effort in installing your eCommercial sites with the contents just like the Demo sites. Please be kindly noted that, with Quickstart, all your existing data will be overwritten. Thus, we recommend using Quickstart for your first installation with our Magento theme or just in case you want to refresh your own site to the very beginning.

Please follow steps as below.

  • Download the Quickstart package from Magento download section.
  • Extract and Upload the whole Quickstart package to your server. In Quickstart folder you will see the extracted folder that includes all sample data.
  • Create a database for your Magento store (using phpMyAdmin).

  • Start the installation process by opening a browser and navigate to your URL (where the Quickstart package uploaded) to load the default Magento installer.

  • Kindly follow each step of the Installer so that the installation process can be set.

Note:

  • Do not use “localhost” in URL, otherwise you could not log into your Admin area (you should use your local IP in case of installing on your computer).
  • Leave “Tables prefix” field blank.

The layout of Bookshop Homepage can be illustrated as below.

In the front-page, Bookshop has these following static blocks.

position-1 | position-2 | position-3 | position-4 | position-5 | position-6 | position-7 | position-8 | position-9 | position-11| position-12 | position-13 | position-14 | position-15 | position-16 | addshare | latest-products | menu-adv | colors | contactinfo | featured-product

To create a new block, refer to the above guide for details.

This section will guide you to configure your pages just as the Demo site of Bookshop.

I. Homepage

See the detailed layout of Bookshop Homepage below.

To configure this page, in the Magento Admin Panel, please navigate to CMS >> Pages. Firstly, create a new page named {Homepage} in “Page Management” section.

  • Page Information Tab: click to see the Back-end Settings.
  • Design Tab: click to see the Back-end Settings.
  • Copy and paste the following code into the “Content” field.

    <reference name="tops1">
    <block type="cms/block" name="position-2">
    <action method="setBlockId"><block_id>position-2</block_id></action>
    </block>
    <block type="cms/block" name="position-3">
    <action method="setBlockId"><block_id>position-3</block_id></action>
    </block>          
    </reference>
    <reference name="tops2">
    <block type="joomlart_jmtabs/core" name="jmtabs">
    <action method="addTabs_staticblock">
      <title>Hot Books</title>
      <identifier>position-4</identifier>
    </action>
    <action method="addTabs_staticblock">
      <title>Best sellers</title>
      <identifier>position-5</identifier>
    </action>
    <action method="addTabs_staticblock">
      <title>Staff Picks</title>
      <identifier>position-6</identifier>
    </action>
    </block>
    </reference>
    <reference name="tops3">          
    <block type="cms/block" name="position-7">
    <action method="setBlockId"><block_id>position-7</block_id></action>
    </block>  
    </reference>
    <reference name="mass-top">         
    <block type="cms/block" name="position-8">
    <action method="setBlockId"><block_id>position-8</block_id></action>
    </block>  
    </reference>
    <reference name="mass-bottom">
    <block type="cms/block" name="position-9">
    <action method="setBlockId"><block_id>position-9</block_id></action>
    </block>        
    </reference>
    <block type="core/text_list" name="mass-head" as="mass-head" translate="label">
    <label>Content Mass Head</label>
    </block>
    
  • Content Tab: click to see the Back-end Settings.

Note:

Other fields should be left blank.

II. 404 Page

To configure this page, in the Admin Panel, navigate to CMS >> Pages, select 404 Not Found 1 page to edit the following settings.

Copy and paste the following code into the “Content” field.

<div id="jm-error">
<div class="page-head-alt">
<h2>404</h2>
</div>
<h3>The page you requested was not found, and we have a fine guess why</h3>
<ul class="none-disc">
<li>If you typed the URL directly, please make sure the spelling is correct.</li>
<li>If you clicked on a link to get here, the link is outdated.</li>
</ul>
<dl><dt>What can you do?</dt><dd>Have no fear, help is near! There are many ways you can get back on track with Magento Demo Store.</dd><dd>
<ul class="none-disc">
<li><a onclick="history.go(-1);" href="#">Go back</a> to the previous page.</li>
<li>Use the search bar at the top of the page to search for your products.</li>
</ul>
</dd><dt>Follow these links to get you back on track!</dt><dd>
<ul class="none-disc">
<li><a href="{{store url=""}}">Store Home</a></li>
<li><a href="{{store url="customer/account"}}">My Account</a></li>
</ul>
</dd></dl></div>

Front-end Appearance:

1. position-1: Customer Service

Back-end Settings

<ul class="customer-services">
<li><em class="icon-phone"></em>(012) 345 6789</li>
<li><a href="{{store url="customer-service"}}"><em class="icon-question-sign"></em>Shipping &amp; Customer Service</a></li>
</ul>

Front-end Appearance:

2. position-2: Slideshow

Back-end Settings

<div class="block-slideshow col-1">{{block type="joomlart_jmslideshow/list" name="jmslideshow" template="joomlart/jmslideshow/list.phtml" }}</div>

Front-end Appearance:

3. position-3: Top 10 books

Back-end Settings

<div class="block block-top-book col-2">
<div class="str">{{block type="joomlart_jmproducts/list" name="view.jmproducts.list" template="joomlart/jmproducts/fourthproduct.phtml" quanlity="4"}}</div>
</div>

Front-end Appearance:

4. position-4: Hot Books

Back-end Settings

<div class="home-slider">{{block type="joomlart_jmproductsslider/list" name="home.jmproductsslider" title="Hot Books"}}</div>

Front-end Appearance:

5. position-5: Best sellers

Back-end Settings

<div class="home-slider">{{block type="joomlart_jmproductsslider/list" name="home.jmproductsslider" title="Best sellers"}}</div>

Front-end Appearance:

6. position-6: Staff Picks

Back-end Settings

{{block type="joomlart_jmproductsslider/list" name="home.jmproductsslider" title="Staff Picks"}}

Front-end Appearance:

7. position-7: Deal of the week

Back-end Settings

<p>{{block type="joomlart_jmproductsdeal/list" name="home.jmproductsdeal.list" template="joomlart/jmproductsdeal/home-deals.phtml" }}</p>

Front-end Appearance:

8. position-8: Shop our store now

Back-end Settings

<p><img src="{{media url="wysiwyg/banner/banner01.jpg"}}" alt="Book" /></p>

Front-end Appearance:

9. position-9: Company Logo

Back-end Settings

<ul>
<li><img src="{{media url="wysiwyg/logo/1.jpg"}}" alt="Book" /></li>
<li><img src="{{media url="wysiwyg/logo/2.jpg"}}" alt="Book" /></li>
<li><img src="{{media url="wysiwyg/logo/3.jpg"}}" alt="Book" /></li>
<li><img src="{{media url="wysiwyg/logo/4.jpg"}}" alt="Book" /></li>
<li><img src="{{media url="wysiwyg/logo/5.jpg"}}" alt="Book" /></li>
<li><img src="{{media url="wysiwyg/logo/6.jpg"}}" alt="Book" /></li>
<li><img src="{{media url="wysiwyg/logo/7.jpg"}}" alt="Book" /></li>
</ul>

Front-end Appearance:

10. position-10: Shipping

Back-end Settings

<div class="block block-shipping">
<div class="inner">
<ul class="list-shipping">
<li class="shipping-item"><em class="icon-plane"></em> <span class="title">Free Shipping</span> <span class="desc">on orders over $49</span></li>
<li class="exchange-item"><em class="icon-refresh"></em> <span class="title">1st Exchange Free</span> <span class="desc">on 3 days</span></li>
<li class="support-item"><em class=" icon-comments"></em> <span class="title">Online support 24/7</span> <span class="desc">123 456 7890</span></li>
<li class="friends-item"><em class="icon-gift"></em> <span class="title">Tell Friends and get $5</span> <span class="desc">a small gift for you</span></li>
</ul>
</div>
</div>

Front-end Appearance:

11. position-11: Newsletter

Back-end Settings

<p>{{block type="newsletter/subscribe" name="left.newsletter" template="newsletter/subscribe.phtml"}}</p>

Front-end Appearance:

12. position-12: Browser

Back-end Settings

<div class="block-browser col-1 first">
<div class="col-inner">
<div class="block-title"><strong><span>Browser</span></strong></div>
<div class="block-content">
<ul>
<li><a href="{{store url="books.html"}}">Books</a></li>
<li><a href="{{store url="ift-cards.html"}}">Gift Cards</a></li>
<li><a href="{{store url="teens.html"}}">Teens</a></li>
<li><a href="{{store url="nook-books.html"}}">Nook Book</a></li>
<li><a href="{{store url="kids.html"}}">Kids</a></li>
<li><a href="{{store url="deal"}}">Deal</a></li>
</ul>
</div>
</div>
</div>

Front-end Appearance:

13. position-13: Information

Back-end Settings

<div class="block-information col-2">
<div class="col-inner">
<div class="block-title"><strong><span>Information</span></strong></div>
<div class="block-content">
<ul>
<li><a href="{{store url="about-magento-demo-store/"}}">About Us</a></li>
<li><a href="{{store url="customer-service/"}}">Customer Service</a></li>
<li><a href="{{store url="privacy-policy-cookie-restriction-mode/"}}">Privacy Policy</a></li>
<li><a href="{{store url="catalogsearch/term/popular/"}}">Search Terms</a></li>
<li><a href="{{store url="sales/guest/form/"}}">Orders and Returns</a></li>
<li><a href="{{store url="catalog/seo_sitemap/category/"}}">Site Map</a></li>
</ul>
</div>
</div>
</div>

Front-end Appearance:

14. position-14: My Account

Back-end Settings

<div class="block-my-account col-3">
<div class="col-inner">
<div class="block-title"><strong><span>My account</span></strong></div>
<div class="block-content">
<ul>
<li><a href="{{store url="customer/account/login/"}}">Sign In</a></li>
<li><a href="{{store url="checkout/cart/"}}">View Cart</a></li>
<li><a href="{{store url="wishlist/"}}">My Wishlist</a></li>
<li><a href="{{store url="checkout/"}}">Check out</a></li>
<li><a href="{{store url="sales/order/history/"}}">Track My Orders</a></li>
<li><a href="{{store url="contacts/"}}">Contact us</a></li>
</ul>
</div>
</div>
</div>

Front-end Appearance:

15. position-15: Location

Back-end Settings

<div class="block-location col-4 last">
<div class="col-inner">
<div class="block-title"><strong><span>Location</span></strong></div>
<div class="block-content">
<p>Address: 2411 Any Street. Any Town. United Kingdom.</p>
<p>Mail to: <a title="[email protected]" href="mailto:[email protected]">[email protected]</a></p>
<p>Phone: +123 456 7890</p>
<p>Fax: +123 456 7890</p>
</div>
</div>
</div>

Front-end Appearance:

16. featured-product: Featured Products

Back-end Settings

<div class="product-menu-featured">{{block type="joomlart_jmproducts/list" name="mega.jmproducts.list" template="joomlart/jmproducts/oneproduct.phtml" quanlity="1"}}</div>

Front-end Appearance:

Note:

The block will be displayed in Mega Menu.

17. latest_products: Popular Books

Back-end Settings

<div>{{block type="joomlart_jmproducts/list" name="category.jmproducts.list" title="Popular Books" mode="latest" quanlity="2" perrow="2" width="150" height="225" template="joomlart/jmproducts/twoproduct.phtml"}}</div>

Front-end Appearance:

Note:

The block will be displayed in Product List Page.

18. contactinfo: Contacts Map

Back-end Settings

<div class="contact-info">
<div class="inner"><iframe src="httpss://maps.google.com/maps?f=q&amp;source=s_q&amp;hl=en&amp;geocode=&amp;q=123+Main+st.+Los+Angeles,+CA,+90012,+U.S.A+&amp;sll=37.0625,-95.677068&amp;sspn=34.176059,86.572266&amp;ie=UTF8&amp;hq=&amp;hnear=123+S+Main+St,+Los+Angeles,+California+90012&amp;t=m&amp;ll=34.051877,-118.243704&amp;spn=0.027023,0.072012&amp;z=14&amp;iwloc=A&amp;output=embed" frameborder="0" marginwidth="0" marginheight="0" scrolling="no" width="100%" height="295"></iframe>
<div class="info-inner">
<p>Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo.</p>
<div class="info-inner2">
<ul class="list-info">
<li class="address"><em class="icon-home">&nbsp;</em><span>Address:</span> 123 Main st. Los Angeles, CA, 90012, U.S.A</li>
<li class="phone"><em class="icon-phone">&nbsp;</em><span>Phone:</span> (315) 457-0000</li>
<li class="fax"><em class="icon-print">&nbsp;</em><span>Fax:</span> (315) 457-1324</li>
<li class="email"><em class="icon-envelope-alt">&nbsp;</em><span>Email:</span> [email protected]</li>
</ul>
</div>
</div>
</div>
</div>

Front-end Appearance:

19. addshare : Social Share

Back-end Settings

<div class="addthis_toolbox addthis_default_style">&nbsp;</div>
<script type="text/javascript">// <![CDATA[
var addthis_config = {"data_track_addressbar":false};
// ]]></script>
<script type="text/javascript" src="//s7.addthis.com/js/300/addthis_widget.js#pubid=ra-51f5e398294794cf"></script>

Front-end Appearance:

20. colors: Colors

Back-end Settings

<div class="colors-setting"><label for="select-colors">colors:</label><a class="colors-default" href="{{store url=""}}?jmcolor=default"><span>default</span></a><a class="colors-blue" href="{{store url=""}}?jmcolor=blue"><span>blue</span></a><a class="colors-green" href="{{store url=""}}?jmcolor=green"><span>green</span></a> <a class="colors-violet" href="{{store url=""}}?jmcolor=violet"><span>violet</span></a><a class="colors-yellow" href="{{store url=""}}?jmcolor=yellow"><span>yellow</span></a><a class="colors-xmas" href="{{store url=""}}?jmcolor=xmas"><span>xmas</span></a></div>

Front-end Appearance:

1. Slideshow Extension

In the Magento Admin Panel, navigate to JoomlArt >> Slideshow and configure the default settings as the Back-end Settings.

Copy and paste the following code into the “Description for each item” field.

[desc img="book01.jpg" url="books.html"]<span class="title">Sherlock Holmes Collection - 3 Books</span><span class="desc">The Hound of the Baskervilles
The Adventures of Sherlock Holmes
A Study in Scarlet</span><div class="readmore"><a title="" class="readon" href="books.html">View more</a></div>[/desc]

In order to get the slideshow displayed at the top position on the front-page, navigate to CMS >> Pages >> select the actual page >> Design tab. Copy and paste the following code into the “Layout Update XML” field.

<reference name="tops1">
<block type="cms/block" name="position-2">
<action method="setBlockId"><block_id>position-2</block_id></action>
</block>      
</reference>

Front-end Appearance

For more detail, please check the documentation of the module.

View Detail Documentation

2. Products Extension

In Bookshop, Magento extension Products supports as the Hot Right Now static block of the Mega Menu. First, to get this extension worked, please follow the Hot Right Now setup in Menu Configuration.

In the Magento Admin Panel, navigate to JoomlArt >> Products and configure the default settings as the Back-end Settings.

Front-end Appearance

For more detail, please check the documentation of the module.

View Detail Documentation

3. Masshead Extension

Masshead Magento extension can be displayed at any position. In Bookshop Demo site, this extension is being used at the header of the category pages.

In the Magento Admin Panel, navigate to JoomlArt >> Masshead and configure the default settings as the Back-end Settings.

To get this extension for any categories, navigate to Catalog >> Manage Categories >> select the actual category as shown in Back-end Settings.

Copy and paste the following code into the “Custom Layout Update” tab.

<reference name="mass-head">
<block type="joomlart_jmmasshead/core" name="jmmasshead">
<action method="setData"><name>background</name><value>wysiwyg/banner/banner01.jpg</value></action>
</block>
</reference>

Front-end Appearance

For more detail, please check the documentation of the module.

View Detail Documentation

4. Basetheme Extension

In the Magento Admin Panel, navigate to JoomlArt >> Basetheme and configure the default settings as the Back-end Settings.

Front-end Appearance

For more detail, please check the documentation of the module.

View Detail Documentation

5. Tabs Extension

Navigate to JoomlArt >> Tabs and configure the default settings as Back-end Settings.

To display this module at the top position onto front-page, copy and paste the following code into the “Custom Design” tab.

<reference name="tops3">
<block type="joomlart_jmtabs/core" name="jmtabs">
<action method="addTabs_staticblock">
<title>All</title>
<identifier>position-4</identifier>
</action>
<action method="addTabs_staticblock">
<title>PC</title>
<identifier>position-5</identifier>
</action>
<action method="addTabs_staticblock">
<title>Xbox360</title>
<identifier>position-6</identifier>
</action>                
<action method="addTabs_staticblock">
<title>PS3</title>
<identifier>position-7</identifier>
</action>               
<action method="addTabs_staticblock">
<title>Wii-U</title>
<identifier>position-8</identifier>
</action>
</block>
</reference>

Front-end Appearance

For more detail, please check the documentation of the module.

View Detail Documentation

6. Mega Menu Extension

Navigate to JoomlArt >> Mega Menu, enable and choose the animation effect for your menu as the Back-end Settings. For detailed configuration of each menu item, please refer to the Menu Configuration.

Front-end Appearance

For more detail, please check the documentation of the module.

View Detail Documentation

7. Product Slider Extension

Navigate to JoomlArt >> Product Slider and configure the default settings as Back-end Settings.

To display this module at the top position onto front-page, copy and paste the following code into the “Custom Design” tab.


<reference name="mass-bottom">  
<block type="cms/block" name="position-13">
<action method="setBlockId"><block_id>position-13</block_id></action>
</block>
</reference>

Front-end Appearance

For more detail, please check the documentation of the module.

View Detail Documentation

8. Quickview Extension

Navigate to JoomlArt >> Quickview and configure the default settings as Back-end Settings.

To display this module at the top position onto front-page, copy and paste the following code into the “Custom Design” tab.

<reference name="mass-bottom">  
<block type="cms/block" name="position-13">
<action method="setBlockId"><block_id>position-13</block_id></action>
</block>
</reference>

Front-end Appearance

For more detail, please check the documentation of the module.

View Detail Documentation

9. Daily Deal Extension

Navigate to JoomlArt >> Daily Deal and configure the default settings as Back-end Settings.

To display this module at the top position onto front-page, copy and paste the following code into the “Custom Design” tab.

<reference name="mass-bottom">  
<block type="cms/block" name="position-13">
<action method="setBlockId"><block_id>position-13</block_id></action>
</block>
</reference>

Front-end Appearance

10. Label Configuration

To label any products, follow these steps.

Step 1: At Theme Settings, select “Yes” value to enable Labelling function.

Step 2: Navigate to Catalog >> Attributes >> Manage Attributes and create a new attribute named Label.

Step 3: Navigate to Catalog >> Attributes >> Manage Attribute Sets to add the “Label” attribute into “Default Attribute Set”.

Step 4: Simply choose the label you want for each product as Back-end Settings.

Bookshop supports Magento extenstion Mega Menu. Follow the guide below to get it configured properly.

In the Magento Admin Panel, please navigate Mega Menu >> Manage Menu Groups. You need to create a Menu group first. For each store language view, you will need to create a different menu group. Once done, select the store language view that you want to create a menu and click “Add Menu Item” button to define the menu items. The default settings belong to English group. Other language groups have similar settings for menu items.

1. Home Menu

Front-end Appearance

Item : Home -- Menu Back-end Settings

2. Books Menu

Front-end Appearance

Note:

Other menu items do have the same settings with the items above.

As a responsive Magento theme, Bookshop supports OffCanvas menu for collapsed screens like mobiles and tablets.

Screenshot of Bookshop layout in various devices.

Screenshot of OffCanvas layout for Bookshop.

All the style files are located in the folder: skin/frontend/default/jm_bookshop/css.

In this particular theme, we support 3 styles: layout in desktop, tablet and mobile. Please be noted that, with the style files in hand, modification for the files need to be defined in the page.xml file located in: app/design/frontend/default/jm_bookshop/layout.

Note:

Please be kindly noted that, the default settings of responsive Magento theme Bookshop support any eCommercial site to work at its best performance. Any modification may not be supported by us.