BERNARD SAULME

BS MyJspace - Configuration

Configuration

Package upload - Install

Do not 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 (and not recommended) to de-install first an old version. No data lost, no configuration lost during update.

The update process is generally safe, but always backup before install or update. So please go ahead and make a site backup, including tables&files, right now. Use, for example, akeeba backup.

Main steps (default) to install

From J!1.6 to J!4.x install the whole package (the 'unzip' file :-) ) file at once

• Backup your Website including the 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 .zip file and click on ‘Upload & install’
• Read the text displayed during install!
• Menu: 'Components' / 'BS MyJspace' / 'Directory'
• Click on ‘Save' (whatever you have done on the previous step, even with no change, click on save).
• Next step: add as minimum the Menu Item 'BS MyJspace / Display' with the 'Menu manager'

Or for all versions, since J!1.5 (install part after part)

• Backup your Website including the 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!
• Menu: 'Components' / 'BS MyJspace' / 'Directory'
• Click on ‘Save' (whatever you have done on the previous step, even no change, click on save).
• 'Upload Package File': select the file plg_myjsp-y.y.y.zip (the editor plugin) and click on 'Upload & install'
• Next step: install all other zip files except plg_quickicon_myjspace_xxxxxx.zip and plg_xtd_pagebreakmyjsp-xxxxxxx.zip (for J! 1.6+ only)
• Next step: add as minimum the Menu Item 'BS MyJspace / Admin + Display' with the 'Menu manager'
• Note: for the modules and plugins you need to use the extensions manager as for the component.

The 'Display (see)' view = I want to view my page(s). It's is recommended to add the view 'search' to list all pages for all users.

Front-end - User's menu link

The next step is to add link(s) to call the component for your users.

- Add MyJspace link(s) to the Front-end (Joomla! Method)

The minimum to have into a menu is the view to 'Display' the page(s).

• 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’ into 'BS MyJspace' component section => 'Display (mandatory)'
• Complete the Menu Item 'Details' section as required (name the menu, for example: 'My page', Access...) and Save
• Note: as default, do not add any page id or page name into the options section.

With this link the user can display the page but also edit and admin using the appropriate icons from the top right of the page of your own page(s) (default position; depending of the template).

You can add the 'menu link' for the view 'admin'. With this link the user can access directly to the configuration view (define page name, access...) but also to the Display, Edit, Search... the personal page.

- My first page

Now, because you followed carefully the previous steps, you have at least a link to 'BS MyJspace called 'My Page' :-)

• Go to your 'Font end'
• Click on the link: 'My page'. Log in, if not already.
• Click on the 'edit' icon
• Write a page content, 'this is my first page...' for example.
• Click on 'save'

That's it; you can see your first personal page. Now you can 'play' with the back-end options... only now.

Upgrade to recent version

Before any upgrade you need to check and be sure to have a 'clean' configuration. Go to the back-end 'help' view to help you to check your configuration for the component. Of course, do not forget to backup your website before any upgrade.

After the migration go back to the back-end 'help' view to re-check.

Downgrade from a version to a previous

You can downgrade from a version to a previous one. But it's not recommended, if you have any issue please request an update instead.

For recent versions just install the pack for the selected BS MyJSpace version.

After the install, go to the back-end, view 'Tools' and click on 'Create folders and index for personal pages' to recreate each pages index.

Specific: to downgrade from a BS MyJspace version >= 2.0.0 (& < 2.2.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). Uninstall the component (and relate modules, plugin...) and re-install the chosen version (the pages will stay not the configuration).

From older versions, you may need to open the Options panel and re-save (even if no change).

Uninstall BS MyJspace pack or component

Since J!1.6+: Uninstall the Pack, uninstall the component+modules+plugins at once. From the back-end: menu => 'Extensions' / 'Extension manager - install' / tab 'Manage' / Select 'BS MyJspace' with type ='package' only and click the button 'Uninstall'.

When you uninstall the Pack or the component, this do not delete (default configuration) the MyJspace table(s) or page(s) folders and file(s) uploaded. Its delete the BS MyJspace's categories, J! tags linked to the pages.

Automatically: with BS MyJspace 2.2.0+ & J!1.6+, you can set the option 'Uninstall table content' to 'yes' before to uninstall the component. During the uninstall component process it will uninstall the MyJspace table and delete the content for the Joomla! tags if any. Delete manually the folder 'myjsp'.

Manually: 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.

1/23