Contents

1. How to move the installation to a new server?

2. How do i install the software?

3. How to change name of the viewer folder?

4. How do i update the software?

5. How to install packages on your server for tools?

6. How do i install the software?

7. What are the requirements?

8. Friendly URL not working on NGNIX web server

9. Friendly URL not working on NGNIX web server

10. Where I can find Tutorials?

11. What are the requirements?

12. How to migrate the license to a new installation?

13. How do i update the software?

14. Reset administrator password

15. I cannot upload files larger than X mb

16. How do i enable SaaS version?

17. Reset administrator password

18. How do i setup?

19. What are the requirements?

20. How do i update the software?

21. I change the language but translations not working

1. How to move the installation to a new server?

1) Copy all the files from your actual server to the new one

2) Dump / Restore the database from your actual server to the new one.

3) Open the file /config/config.inc.php and change the database parameters

4) If you change the domain name or ip address of the server, remember that you must invalidate your license (by put an invalid purchase code inside your settings) on the old server in order to then be able to use it on the new installation.

Remember to change your DNS settings pointing to your new IP server if you want to maintain your domain name

2. How do i install the software?

1) unzip codecanyon_XXXXXXXX.zip
2) copy all files and directories into your hosting server
3) copy all your mp3 files to songs directory

3. How to change name of the viewer folder?

Put a file .htaccess inside the root of the application with this content (change new_viewer_name with desired name):

<ifmodule mod_rewrite.c="">
    RewriteEngine On
    RewriteBase /
    RewriteCond %{REQUEST_URI} ^/([^/]+)
    RewriteRule ^new_viewer_name/(.*)$ /%1/viewer/$1 [L]
</ifmodule>

4. How do i update the software?

0) Back up files and database of previous version 

Automatic update (version 5.8.1+) 
1) Log in to your backend with the administrator account 
2) In the sidebar menu, click Update 
3) Click UPDATE NOW! 

Semi-Automatic update (version 6.5.1+) 
1) Upload the zip into your root directory and rename it to update_svt_m.zip
2) Log in to your backend with the administrator account 
3) In the sidebar menu, click Update 
4) Click UPDATE NOW! 

Manual update (if the automatic method doesn’t work) 
1) Unzip the new version of simple_virtual_tour.zip 
2) Upload new versions of the files and directories by replacing them in the root of your hosting server being careful not to delete the existing contents 
3) Log out of the backend and log back in 
NB It is not necessary to run the installer again 

If Automatic Update not working try to adjust these PHP settings:
- allow_url_fopen: enable this
- max_execution_time: max execution time of scripts (Suggested: > 300)
- memory_limit: not equal to post_max_size or upload_max_filesize (Suggested: > 512M)

5. How to install packages on your server for tools?

In order to install the packages needed to make works some extra tools of the application you need a server with Debian/Ubuntu as OS and root privileges to access into SSH terminal.

These are the commands for install all the required packages:

apt-get install python3 python3-pil python3-numpy python3-pip
apt-get install hugin-tools
pip3 install pyshtools
apt-get install ruby-fastimage

If your operating system is ubuntu 22.04 and you can't install the hugin-tools package, fix it by running these additional commands:

add-apt-repository ppa:ubuntuhandbook1/hugin
apt-get update
apt-get install hugin-tools

6. How do i install the software?

1) Create an empty database on your server panel and take note of the access parameters, you will be prompted in the installer.
2) Unzip codecanyon_XXXXXXXX.zip file.
3) Copy all files and directories from the codecanyon_XXXXXXX directory into your hosting server root or subdirectory.
4) Access with your browser to http://yourserver/directory/install/start.php (replace your server/directory with the correct path).
5) Follow the wizard and complete the installation.

7. What are the requirements?

Server: PHP 5.6+

8. Friendly URL not working on NGNIX web server

Add these directives inside your NGNIX server configuration.

location / {    
    try_files $uri $uri/ /index.php?$args;
}
location ~ ^/viewer/(ajax|content|css|gallery|header|icons|js|maps|media|objects360|panoramas|pointclouds|products|vendor|videos)/ {
}
location /viewer/ {    
    rewrite ^/viewer/(?!index\.php)(.+?)/?$ /viewer/index.php?furl=$1 last;
}
location ~ ^/vr/(css|font|img|js|vendor)/ {
}
location /vr/ {    
    rewrite ^/vr/(?!index\.php)(.+?)/?$ /vr/index.php?furl=$1 last;
}
location /landing/ {    
    rewrite ^/landing/(?!index\.php)(.+?)/?$ /landing/index.php?furl=$1 last;
}
location ~ ^/globe/(css|img|js)/ {
}
location /globe/ {    
    rewrite ^/globe/(?!index\.php)(.+?)/?$ /globe/index.php?furl=$1 last;
}
location ~ ^/showcase/(css|js|ajax)/ {
}
location /showcase/ {    
    rewrite ^/showcase/(?!index\.php)(.+?)/?$ /showcase/index.php?furl=$1 last;
}
location ~ ^/map/(css|js|ajax)/ {
}
location /map/ {    
    rewrite ^/map/(?!index\.php)(.+?)/?$ /map/index.php?furl=$1 last;
}
location /api/ {
    rewrite ^/api/([^./]+)$ /api/$1.php last;
}

9. Friendly URL not working on NGNIX web server

Add these directives inside your NGNIX server configuration.

location / {    try_files $uri $uri/ /index.php?$args;
}
location ~ ^/viewer/(ajax|content|css|geoimages|geojson|header|icons|images|js|logos|map_styles|marker_images|vendor)/ {
}
location /viewer/ {    rewrite ^/viewer/(.+?)/?$ /viewer/index.php?furl=$1 last;
}
location ~ ^/showcase/(css|js)/ {
}
location /showcase/ {    rewrite ^/showcase/(.+?)/?$ /showcase/index.php?furl=$1 last;
}

10. Where I can find Tutorials?

Here https://simplevirtualtour.tawk.help/

11. What are the requirements?

Server
PHP 7.1+
Mysql

PHP Extensions
gettext - zip - curl - gd - imagick - mysqli - intl

Apache Extensions
mod_headers - mod_rewrite - mod_deflate - mod_expires

PHP Settings  
Required  Recommended
session   YesYes
shell_exec NoYes
allow_url_fopen YesYes
file_uploads YesYes
max_execution_time 60300
max_input_time 60300
max_input_vars No5000
memory_limit 128M512M
post_max_size NoMax upload size
upload_max_filesize NoMax upload size
set_time_limit NoYes

TOOLS

N.B. In order to install some packages on your server you need root SSH privileges.

Multiresolution (optional)
Debian/Ubuntu OS
python3 
python3-pil 
python3-numpy 
python3-pip 
hugin-tools 
pyshtools

Video 360 Tour 
python3

Gallery Video Slideshow 
ruby 
ruby-fastimage

Video Projects 
Linux kernel 3.2+


FEATURES
These features work through the related services installed on the SVT server, to create your own services follow the relevant guides.

Live Sessions
PeerJS Server
Coturn (TURN/STUN Server)

Meetings
Jitsi Meet Server


12. How to migrate the license to a new installation?

1- Log in into backend of the current installation

2- Go to Settings - License

3- In the Purchase Code field enter an invalid code, click Check and then Save

4- You can now use your license in the new installation

If the above does not work, just open a ticket in the "License Migration / Problem" category, that doesn't require an active support!

13. How do i update the software?

1) backup songs directory
2) upload new file versions into your hosting server root directory
P.S. if directory(1) missing or empty, restore from your backup copy

14. Reset administrator password

1. Login into svt database from your server admin panel

2. Go to table svt_users

3. Find the corresponding line of the administrator and mark his ID

4. Run this query (replace your_new_password and ID)

UPDATE `svt_users` SET `password`=MD5('your_new_password') WHERE id=ID;

for example

UPDATE `svt_users` SET `password`=MD5('changeme') WHERE id=1;

15. I cannot upload files larger than X mb

Adjust PHP settings to allow uploading large files:
- max_execution_time: max execution time of scripts (Suggested: > 300)
- max_input_time: max execution time of upload (Suggested: > 300)
- memory_limit: not equal to post_max_size or upload_max_filesize (Suggested: > 512M)
- post_max_size: the maximum size of the file you want to upload (this value need to be larger then upload_max_filesize)
- upload_max_filesize: the maximum size of the file you want to upload

If you are under NGNIX server you need also to increase the client_max_body_size to the same or greater value of post_max_size.

16. How do i enable SaaS version?

1) Buy the SaaS plugin here
2) Login into application Backend, go to the Settings - License tab and enter the purchase code from Envato of the SaaS plugin to unlock the SaaS features.
N.B. No need to reinstall the software

17. Reset administrator password

1. Login into sml database from your server admin panel

2. Go to table sml_users

3. Find the corresponding line of the administrator and mark his ID

4. Run this query (replace your_new_password and ID)

UPDATE sml_users SET `password`=AES_ENCRYPT('your_new_password','sml') WHERE id=ID;

for example

UPDATE sml_users SET `password`=AES_ENCRYPT('changeme','sml') WHERE id=1;


18. How do i setup?

QUICK START

In HTML, include jquery if not already present

In HTML, include thescript:

Create a container with a custom id where the music player is to appear:

Add it to your stylesheet to define size of the player:
#smp_container {
width:100%;
height:100vh;
}

Finally call in your javascript this function with the id of the previous container to init the player:
init_smp('smp_container', 'songs');

If you want to initialize the player with a different folder just pass the relative position as second
parameter

OPTIONS

init_smp('smp_container','songs',{
waveform_width: 3
});

waveform_width: 0-10 (default 3)
0 hide the waveforms
1 more accurate, 10 less accurate

ADD LIVE STREAMS

1) create a file called name_live_file.live

2) inside the file created put this content (replace url name and artist)
{
"url":"https://icecast.omroep.nl/radio1-bb-mp3",
"type":"direct",
"name":"Radio 1 bb",
"artist":"Icecast"
}

2b) For old shoutcast 1 servers try to put type value as shoutcast_v1

3) if you want to add a cover image create a jpg file 500x500 and name it name_live_file.jpg

4) upload .live and .jpg files to songs directory

19. What are the requirements?

Server
PHP 7.4+
Mysql

PHP Extensions
gettext - zip - curl - gd - imagick - mysqli - intl

Apache Extensions
mod_headers - mod_rewrite - mod_deflate - mod_expires

20. How do i update the software?

0) Back up files and database of previous version 

Automatic update (version 2.9+)
1) Log in to your backend with the administrator account 
2) In the sidebar menu, click Update 
3) Click UPDATE NOW! 

Manual update (if the automatic method doesn’t work) 
1) Unzip the new version of codecanyon_XXXXXXXX.zip 
2) Upload new versions of the files by replacing them in the directory of your hosting server being careful not to delete the existing contents 
3) Log out of the backend and log back in 
NB It is not necessary to run the installer again 

If Automatic Update not working try to adjust these PHP settings:
- allow_url_fopen: enable this
- max_execution_time: max execution time of scripts (Suggested: > 300)
- memory_limit: not equal to post_max_size or upload_max_filesize (Suggested: > 512M)

21. I change the language but translations not working

- make sure that the PHP extension gettext is installed into your server
- double check if your server have the correct language locale installed, for example de_DE for Germany. If you have ssh access to your server run the command locale -a to check it.
- if the language is not listed in the above output, run these commands to install it: locale-gen de_DE and locale-gen de_DE.UTF-8
- restart the web server