Shack Pack Documentation

Category: Documentation
The Shack Pack is a complete installation of Joomla, which will require manual setup / installation and cannot be simply installed to an existing Joomla site.

If you're using the Shack Pack for the first time, this is an explanation on how to set it up, how the different categories / articles / modules are integrated into your new site, and what you can do with them.

Heads Up! The Shack Pack for Schools demo is displaying content with a Professional template from Joomlashack named Impacto. For complete template documentation, please see the Impacto Demo.

If you have any questions about setting up, installing, or using this pack, please post in the Joomla for Schools forum we've set up for help.


There are some steps you will need to follow to get your ShackPack site up and running.

① Create a database

To create the ShackPack website database open your phpMyAdmin or if you are using cPanel go to the database section and select 'MySQLDatabases'

In phpMyadmin select 'Databases' and in the text box provided enter a title for your ShackPack database. Choose your prefferred collation from the drop down menu provided. Its a good practice to keep a text file with website details including all the database details. Including database name, usernames and passwords.

When using cPanel and 'MySQLDatabases' the first thing you need to do is enter the name of your new database in the field entitled 'Create new database'

Further down the page you will find a field entitled 'Add new user' you will need to create a new user here if one does not already exist. Use the password generator provided when creating a new user and save it in your website details text document for use later.

Finally you need to add a user to the new database. Once you have added a user you need to assign them all privileges when the pop up appears.

Return to the cPanel and setting up the database is complete.

② Installing ShackPack for Schools (Joomla and Pack content)

Download ShackPack for schools from your Joomlashack account and then upload it into the directory you have chosen. Usually this will be the root html folder in an external hosting environment.

Once uploaded extract the file.

Now visit the site URL where the instalation process will have begun.

③ Preferred Language.

Once complete select 'Next' in the top right of the page.

step one

④ Pre-instalation Check.

Select 'Next' if everything is marked in green. You will need to address any issues that have been highlighted in red before moving on to the next step.

step two

⑤ General Public License.

It is well worth a read if only to learn something about how to best promote the use of free software.

step three

⑥ Connection Details.

For this step you will need the database name, the username for that database and the password. All of these details you should have copied when creating the database. Once you have entered the details select 'Next'.

step four

⑦ FTP Details.

Heads up! Most people do not need this option. You can skip this step and select next to move onto step 6. If you should need you can set this up later after Joomla has been installed.

step five

⑧ Site Configuration.

Enter the details that you will be using on the site. Including: The site name, your email, the site username and password that you will use to log into the site.

Important You must select to Install 'ShackPack for Schools Data' at this point!

Doing so will ensure you install the ShackPack for schools default content.

step 6

⑨ Remove Installation Folder

Click the link to remove the Installation Folder. Once you have selected it you will be able to visit the sites front-end or administrator. To access the administrator use the details you provided during step eight.

step seven

Congratulations you now have a complete website that you can populate with your own details and content.

If you experience any problems installing your ShackPack for Schools then please post in the ShackPack forum where we will be happy to help


Category Structure

We provide two options for installation with this pack, a single language installation and multi-language (English and Spanish) installation.

The categories and content are the same with both installations, with the main difference being that the multi-language install has categories and content added in both languages

If you have any questions about which installation you should use, please post your inquiries in the Shack Pack for Schools forum.

ShackPack for Schools default installation has two main categories of English and Spanish.

Under the main categories are six sub-categories of:

Categories

These categories are the main parts of the site and will help you get your ShackPack for School website up and running as quickly as possible.

Creating a new category

When creating a new category you must ensure that you select the language from the drop down selections for 'Language'

category language

ShackPack for Schools Menus

If you hover over the 'Menu' menu item you will see that each default menu has has a flag beside it showing the language for that menu.

menus

Menu Structure

The menu structure is much the same as the category structure apart from a couple of additions, including a menu item for the documentation.

Creating a new menu item

Whenever you create a new menu item you need to ensure that you choose the correct language.

Before saving the menu item check that you have selected the language from the language selector in the template details shown below.

menu language


Article Structure

ShackPack default articles are set out in alphabetical order.

If you are looking to add content to a particular article the easiest way to find it is to display the parent category and select it from the list provided.

Most default articles contain holding text which you simply delete and add your own content to.

select category

Creating a new Article

When creating a new article ensure that you select the correct parent category from the drop down provided.

You will also need to select the language for your article.

article creation

Adding Images to an Article

Adding images to articles in Joomla is made a lot simpler with the new image options.

There are two main options for adding articles. These are the 'Intro Image' and the 'Full article image'

The intro image is displayed before a read more line in a Category Blog layout style with the Full Article Image being displayed once the Read more button has been selected on the front end.

article images


Joomla modules allow you to place content 'around' your main article content. Each Joomla template is different, providing module positions specific to to the template, however, most will use some logical naming for positions such as 'sidebar' or 'above-content', etc. Knowing the module positions available in your template is key to knowing how to set up your site with the template's available positions.

Module Positions

The Shack Pack for Schools, using the Impacto template, provides the following positions for modules

Grids-WV3

Menu Modules

The Shack Pack for Schools uses default Joomla menus in the 'menu' and 'sidebar1' positions, and also adds a 'Sub Menu' in sidebar1 that will show a list of child items for the parent category that is selected in the main menu.

Main Menu in Sidebar1

The Main Menu in sidebar1 is set to only show the top level items from horizontal menu in the menu position. We hide the child items by setting an End Level of 1 :

ss menu

The main menu module in sidebar1 uses a module class suffix of nav-pills nav-stacked which provides the style seen, added in the module class suffix proceeded by a space as seen below:

Main Menu Module Settings

Sub Category Menu in Sidebar1

The Sub Category Menu in sidebar1 is set to show the child items from the main menu only, so that when a parent is selected, we have a menu of that parent categories child items. This is done by setting the menu to start at Level 2 links:

Sub Category Menu - Basic Settings

And the module is styled with a Menu Class Suffix of nav-tabs and a Module Class Suffix of tabbable tabs-left

Sub Menu - Advanced Settings


Included Extensions

The Shack Pack for Schools comes with several commercial Joomlashack extensions as well as some industry leading free extensions that will be benefit a School website. The following is a list of the extensions installed with some basic documentation and / or links to full documentation for the extensions.

Heads Up! While we provide this pack with some 3rd party extensions installed, we do not provide support for any 3rd party extensions, and it is important to make sure you keep the extensions updated with updates provided by the extension providers.

Joomlashack extensions

Visionary

The Visionary Joomla component by Joomlashack is a new way to manage and display image collections as slideshows on your Joomla powered site.

Visionary Documentation

Shackslides

ShackSlides is not just a slideshow module, but a way to feature your images in style. The most powerful feature of ShackSlides is the ability to utilize content items as the source for your slideshow.

You can see Shackslides in action on the homepage of your ShackPack for Schools.

Shackslides Documentation

Lifestream

Lifestream allows you to display feeds from many social networks in modules and content, as well as selecting a Joomla category as a source for your feed.

Lifestream Documentation to come!

Third Party Extensions

JCE - WYSIWYG Editor

Add a set of tools to your Joomla!® environment that gives you the power to create the kind of content you want, without limitations, and without needing to know or learn HTML, XHTML, CSS.

JCE Documentation

To use the JCE as default editor, open the global configurations and select it from the 'Default editor' drop down.

JCE default

Akeeba Backup

Backup, restore and transfer your site in seconds with the most popular Joomla! component. 4.7 million downloads and counting!

Akeeba Backup Documentation

AllVideos

AllVideos (by JoomlaWorks) is truly THE all-in-one media management solution for Joomla! and a classic must-have extension for any Joomla! based website.

You can use the plugin to easily embed media hosted on popular services like YouTube, Vimeo, Dailymotion, SoundCloud (and many more) inside your Joomla! articles (or K2, redShop, Virtuemart etc).

AllVideos Documentation

Additionally, it allows you to playback almost any video/audio file format hosted on your server or even a remote server, providing great flexibility when it comes to media content embedding. Fun videos, product presentations, audio podcasts, you name it!

Simple Image Gallery

Simple Image Gallery can turn any folder of images located inside your Joomla! website into a grid-style image gallery with cool lightbox previews.

It provides a very simple way to add simple immage galleries right into your Joomla content.

Simple Image Gallery Documentation