Bernard Saulme

softs

Search

Skip to content

BS MyJspace - Configuration

Index

MyJspace

Configuration

Package upload - Install

Do no forget to uncompress the file bsmyjspace_pack_x.x.x_UNZIPME.zip you just downloaded. The modules, plugin and component are included in this file. Use the new zip files to install.

To install the new release, use the Joomla Installer. It is not necessary to de-install first an old version. No data lost, no configuration lost. The update process is generally safe, but it's always a good idea to make a backup before updating. So please go ahead and make a backup of your site, including tables, now.

Topic: due to the size of the TinyMCE editor included it is advisable (mainly if the link to you server is slow) to upload after unzip (using FTP) into your '/tmp' directory (in your Joomla Website). Then you can use the 'install from Directory' method to install it.

Main steps (default) to main install

For J!1.6, J!1.7 & J!2.5 you can install the whole package (the 'unzip' file :-) ) file without unzip first since BS MyJspace 1.7.3+

Save all your Website including database
Download the latest BS MyJspace pack
Use the Joomla back-end interface. Log-in as administrator on your Joomla Website (default 'admin')
Menu: 'Extensions' / 'Extension Manager'
'Upload Package File': select the file and click on ‘Upload & install’
Read the text displayed during install :-). Continue to the next step
Menu: 'Component' / 'BS MyJspace' / 'Directory'
Click on ‘Save' (what you have done in the previous step, even no change, click on save). Do not chose 'myjspace' for the dir name if you are using redirects with .htaccess file based on the default Joomla .htaccess file
Next step: add as minimum the Menu Item 'BS MyJspace / Admin + Display' with the 'Menu manager'

For all versions since J!1.5 (install part after part)

Save all your Website including database
Download the latest BS MyJspace pack
Unzip the uploaded file: bsmyjspace_pack_x.x.x_UNZIPME.zip. You will obtain several .zip files and a .txt file
Using Joomla back-end interface log-in as administrator on your Joomla Website (default 'admin')
Menu (J1.5): 'Extensions' / 'Install Uninstall'
Menu (J1.6+): 'Extensions' / 'Extension Manager'
'Upload Package File': select the file com_myjspace-y.y.y.zip (the component) and click on ‘Upload & install’
Read the text printed during install :-). Continue to the next step
Menu: 'Component' / 'BS MyJspace' / 'Directory'
Click on ‘Save' (what you have done in the previous step, even no change, click on save). Do not chose 'myjspace' for the dir name if you are using redirects with .htaccess file based on the default Joomla file
'Upload Package File': select the file plg_myjsp-y.y.y.zip (the editor plugin) and click on ‘Upload & install (BS MyJspace 1.8.0+)
Next step: install all other zip files except plg_quickicon_myjspace_xxxxxx.zip (for J! 1.6+ only)
Next step: add as minimum the Menu Item 'BS MyJspace / Admin + Display' with the 'Menu manager'

For the modules and plugins you need to use the extensions manager as for the component.

Users menu links

The next step is to add links to call the component for your users.

Add links to the user using the classic Joomla Method

Log in to the Joomla! back-end
If needed, create a new Menu using the Menu Manager
Select the Menu you wish to add an item to from the "Menus" drop-down menu
In the Menu Item Manager, click the New toolbar button to open the Menu Manager: New menu Item screen
Select the appropriate ‘menu item type’. For example for user admin panel BS MyJspace > Admin
Complete the Menu Item Details section as required (name the menu, for example: 'My page Admin') and Save
Do the same with 'Display' (to display a page).

With this link the user can access to the configuration menu but also to the Display, Edit, See …Search ...the personal page. The minimum to have into a menu is 'Display' and 'Admin' if you want that your users admin they pages. If more than one page per user, add 'User pages list'.

Myjspace module

If you don’t feel comfortable with Joomla menu configuration, there is another possibility. This is mainly for testing. Install the BS MyJspace module and don’t forget to enable it (chose the position too). This module installs the previous link like a menu. The menu offers some options too (you can chose to have the optional links (edit, delete = 3 links) and add again search in the pages (4 links).

My first page

Now, because you followed the previous steps, you have at least a link to 'BS MyJspace user admin' :-)

Go to you Website 'Font end'
Click on the link just created: 'My page Admin'. Log in, if not already.
Chose a page name, or keep the username, and click on 'save'
Click on 'edit'
Write a text, 'this is my first page...' for example.
Click on 'save'

That's it; you can see your first personal page

Update from the old historical version myjspace (<= 1.2)

In this case, BS MyJspace updates the old tables to add new features. It uses the original directory creation date to migrate to the new feature 'creation date' for user information. Be careful; do not delete your existing MyJspace tables. Do not delete this old version using Joomla extension manager. Recent version of the component updates all itself.

Downgrade from a version to a previous

You can downgrade from a version to a lower version. Uninstall the component (and relate modules, plugin ...) and re-install the chosen version.

To downgrade from a version >= 2.0.0 to a version < 2.0.0 you need to have only one page per user before uninstall the component (delete the extra pages using the component >= 2.0.0 first).

Note: Uninstall the component do no delete the data for the pages into database neither the user's folders and files.

Uninstall BS MyJspace pack or component

For J1.6+: Uninstall the Pack, it will uninstall the compoenent/modules/plugins at once. From the backend : menu => 'Extensions' / 'Extention manager - install' / tab 'Manage' / Select 'BS MyJspace' with type ='package' and click the button 'Uninstall'.

When you uninstall the Pack or the component this do no delete the MyJspace table(s) or page(s) folders and file(s) uploaded.

If you want to delete all: delete the table(s) #__myjspace and #__myjspace_cfg (if any, depending of the version for this last one), and delete the folder 'myjsp' (or the name you chosen) and the content.

Directories which needs to have write permissions

The following directories need to have write permissions, in order to allow installation.

/administrator/components
/components
/plugins
/plugins/system
/tmp
/ (for page root folder, usualy here)

1/17