BS MyJspace - Configuration

Index

En Fr

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

noticeThe update process is generally safe, but always backup before intall 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

For J!1.6, J!1.7, J!2.5 & J!3.x you can 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: 'Component' / 'BS MyJspace' / 'Directory'
  • Click on ‘Save' (whathever 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: 'Component' / 'BS MyJspace' / 'Directory'
  • Click on ‘Save' (whathever 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 (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.

 

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 FrontEnd (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 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 backend 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.

To downgrade from a 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).

After the install, go to the backend, view 'Tools' and click on 'Create folders and index for personal pages'.

For other 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 backend: 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. It deletes the BS MyJspace's categories.

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.

Directories which needs to have write permissions

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

/administrator/components
/administrator/language/xx-yy
/components
/language/xx-yy
/modules
/plugins
/plugins/system
/tmp
/ (for page root folder, usualy here)