Documentation

SP Kindergarten

SP Kindergarten component with included modules (Joomla 3.5+) was especially developed for Kidzy template purposes. It allows you to add and manage courses, teacher profiles, events, speakers and other relevant stuff. This tool will help You to manage kinder-garden, preschool or elementary school site. It has its own language file so can be used on multilingual site: Fröbelschool, Børnehave, Jardin d'enfants, Jardín de infancia, Przedszkole and Детский сад.

SP kindergarden

How to install SP Kindergarten

The first thing you need to do is to download package with extension. It includes all component and two modules inside. Second tip, the installation process for Joomla extensions is the same as the one for templates. Simply choose Extensions→ Manage→Install in any back-end page to install zip file. All you need to do is hit the Browse button, browse to the location of your extension's archive on your local computer, and press the Upload & Install button.

how to install component joomla 3.5

When it finishes, it displays a message (on green background) telling you that installation was successful. Now that you’ve installed your component, you’re going to want to get it up and running smoothly. That means looking to the SP Kindergarten component’s configuration.

How to add/manage classes

The Classes can group courses into one school "category". Only few fields are requested: Title, Image and Description.

class

How to add/manage courses

You can add new or modify current kids courses prepared by Kindergarten teachers / owners. Here is a front-end view of courses list, with sorting names.

courses

The Courses list gives you a possibility to view a full list of currently created courses. A user logged in back-end can enroll into courses published by other users, create new courses, as well as manage courses: publish, delete, edit.

details - settings

How to add/manage teachers

Teachers play an important role in fostering the intellectual and social development of children during their formative years. In SP Kindergarten each teacher can have its own profile. It can contain Name, Designation, Photo, Bio description, Social links and Timeline with his/her professional experience. Their profiles are presented on course detail page after main description.

profile

The kindergarten teacher is the liaison between other adults in the school -- special teachers of art, music and physical education, and office personnel. He/She must also communicate closely with every child's parents. They must teach students basic skills in reading and writing in addition to showing them how to behave in the classroom and play nicely with others. A kindergarten teacher must serve as educator, surrogate parent and psychologist in order to mold students who are well-adjusted and eager to learn. And His/Her online profile on website can help parents to make decision if this teacher or whole kindergarten is good for their children(s).

teacher profile

How to add/manage events

SP Kindergarten allows you to create a events in school. We want everyone’s kindergarten years to be as much fun as possible – for children and for parents! These meetings are mostly designed for parents. But Kindergarten Bridge events are a great opportunity for child to get comfortable in a kindergarten room before school actually starts.

events Inside event details following fields that can be used:
  • Event Title
  • Date & Time with countdown clock
  • Location
  • Main Image
  • Description
  • Speakers & Guest Of Honor
  • Event Location on Google Maps

Courses Module

module 1

Latest Events Module

module 1

How to create translation

Phrases from SP Kindergarten component and modules can be easy translated, on both sides.

Front_end

All the .INI translation files for the front-end part of the site are located in /language/en-GB/ and that directory will contain all the default language files.

  • language\en-GB\en-GB.com_spkgarten.ini
  • language\en-GB\en-GB.mod_sp_kindergarten_events.ini
  • language\en-GB\en-GB.mod_sp_kindergarten_courses.ini

Back-End

All the .INI translation files for the administrator section of the site are located in /administrator/language/en-GB/ and that directory will contain all the default language files for the back-end.

  • administrator\language\en-GB.com_spkgarten.ini

Translation procedure - step by step

Let's say you would like to translate the component to German, these are the steps you should follow:

  1. Copy the file /language/en-GB/en-GB.com_spkgarten.ini into the folder /language/de-DE/
  2. Rename the file as /language/de-DE/de-DE.com_spkgarten.ini
  3. In editor open the file de-DE.spkgarten.ini and translate all (or selected) the English phrases into German.
  4. Save the changes.
How to create translation for SP Kindergarten

In our example we used German prefixes, please use your native, required prefix (es-ES=Spanish etc.).

Files should be saved as UTF-8 without BOM encoding. Do not delete any quotation marks, keep them all. Of course, you can translate all phrases or only selected. Using a good text-editor for translating the .INI language files is a good practice. Most of them come with a syntax highlighter that will be helpful during the translation. We suggest Mac OS users to download and use the text-editors TextMate or Sublime Text. Linux users can use their native text-editor or gEdit. All Windows users should use Notepad++ or similar tool.

Also modules use .INI language files named en-GB.mod_kindergarten_.....ini and they are always located in the /language directory of your website. For example, if you wanted to translated the module, the file you should copy, rename and translate. By creating a translated-copy of that file in your language folder, the module will be translated with all its wordings. Procedure is exactly this same like we described above for component.


Code customization

To change HTML/PHP code you can edit core files of component (not recommended) or use Joomla Template Override system to override only views, like we did for articles, portfolio etc.

Tips:

  1. Create new folder inside current used template: templates\shaper_TemplateName\html\com_spkgarten
  2. Copy there all (or selected) folders with files inside from components\com_spkgarten\views
    and then inside those folder, you can safe edit all files, components views.

You can also update template without worries to lose customization changes.

Newsletter