EInführungshandbuch EN
Contents
1. gt B L Slee penton 2 Inthe Tool Bar click Cut To make sure that is really what you want to do you will be asked to confirm your intention http 127 0 0 1 Do you want to move the selected page s to the clipboard C Abbrechen 0K J 3 Click OK The Test Page with Link will be removed from its current position and you will see the parent page in this case the Welcome page When you cut the page it will be placed on the Clipboard which is shown above the Trash can in the Navigation pane The Clipboard is a kind of universal temporary storage used not only for moving pages but also for making copies and links 40 Introduction to Virthos 12 1 2006 Getting Started 4 Bringup the Clipboard Click Clipboard in the Navigation Bar The Clipboard is displayed eoe Virthos masterBVirehos Test Basic 2 0 Dienas ph01 99 1974amp met vieorkisaceamp wie O G ny ES o sw Clipboard Just as in the case of the Trash and every other page you can also see which pages are subordinate to the Clipboard by selecting the Structured view 5 Inthe Mode Selector click Structure The Structured view of the Clipboard is displayed e ate Le E wi 6 Go back to the Preview In the Mode Selector click Preview The Clipboard is again displayed 7 Bring up the Welcome page again The page that was cut shall now be inserted 8 In the Tool2. Q Introduction to Virthos System Requirements Installation Getting Started Version 2 0 Revised December 1 2006 O 2006 Virthos Systems GmbH Contrescarpe 8c 28203 Bremen Germany Email info virthos net www virthos net Virthos is a registered trademark of Virthos Systems GmbH Bremen Germany Table of Contents Table of Contents Welcome to Vinhos ciet itr tro t Feet re RR Te ree D eee esee gero 5 What s New in Version 2 0 s oeste rere tr ort reet b eoe 6 About This Manual eie UR eee ep ERE ERE ES 7 Installation Requirements nennen emen nennen 9 Installing and Uninstalling Virthos ese 11 Using the Online Installation Program see 12 Manual Installation ci ER EE ves ety en LERRA Le URL 13 Concluding and Testing the Installation see 16 Uninstalling ssiri ER 18 Getting Started ee eret eU EEEE S 19 Accessing Web Pages eee e e S Oe o ia Serio eee S 19 Starting and Stopping Virthos Manager sse 22 Changing the Master Password sssssssssseeseeeeeneeenee eene 26 Editing Content EE 27 Creating New Pages irt etceien aet t pep EE eerte etia ee icr eR e be panes 29 Designing Your Own Templates sess 32 Deleting Pages ee RO UR peret bie Leni ete e Exe tats 38 Quer RR 40 Becr sich sates cfeuace ssa setas sate O E ERER dems roects Pian oobi a AL iasaveld 43 Software License Agreement e
3. Even the so called safe mode that some providers activate in their hosting environments does not affect Virthos functionality Workstation Requirements Since Virthos has no effect on the HTML code of existing websites there are no special requirements for the workstation that accesses Virthos pages from the web server This means that even older web browsers can be used as long as the pages themselves do not make any special demands If a user has disabled cookies or JavaScript this will not affect the way that Virthos works There are only two minor requirements for the web browser on the computer on which content for Virthos is edited Frames must be supported JavaScript 1 3 must be supported Virthos has been successfully tested with the following browsers Internet Explorer 5 5 6 0 Firefox 1 x Windows and Mac OS and Safari 1 3 2 0 Introduction to Virthos 12 1 2006 9 Installation Requirements 10 Introduction to Virthos 12 1 2006 Installing and Uninstalling Virthos Installing and Uninstalling Virthos To use Virthos you first need to create some directories on your web server and copy some files that are specific to Virthos Permissions for these directories and files must be set to specific values and for the Pro version the mySQL access information must be entered in the configuration file All this can be done using the Online Installation Program found at www virthos net or manually Any
4. Submit the form for processing In the Tool Bar click Save In a few seconds you will see the page you have just created in the Content Area eoo Virthos master Virthos Test Basic 2 0 Q 602 127 0 0 1 vehos basic2 0 vethos pho ox 1976amp metevtworkspace amp ami Q eer Name master ECTS ee da i ial We wil 3007 mate avaliable some tegal ieformation about out company It will also appear in the Navigation Bar on the left 30 Introduction to Virthos 12 1 2006 Getting Started 6 Return to the Welcome page There are three ways to get back to the Welcome page Click the Back hyperlink above the title Legal Click Welcome in the Navigation Bar n the Status Area within the path click Welcome You will again see the Welcome page which will now display a link to the newly created Legal page below the text area This happens because the simple page template is designed to automatically show all subordinate pages that are based on it Try creating another page using the procedure we have outlined Introduction to Virthos 12 1 2006 31 Getting Started Designing Your Own Templates As we mentioned in the last section each page in Virthos is based on a template The real effort needed to shape your website using Virthos is in developing and designing these templates However if you have already gone through the process of fashioning your own HTML pages which we will now a
5. You must again pay a license fee in order to use Vir thos software as a registered version at the new address In this situation as well there exists no right to exchange a license key that has become invalid for a valid key If you lose a license key you may ask for a replacement to be sent by showing proof of your purchase The proof of purchase must include the date of purchase purchase price the software version and the network address The licensee is responsible for the costs of the new delivery of the license key You may not sell loan or lease the demo version nor grant sublicenses for the Virthos software You are however permitted to effect a one time permanent transfer of all your license rights to the Virthos software to one other party provided that the transmittal includes this License Agreement and that the party that receives the software reads and accepts the terms of this License Agreement 4 Restrictions You obligate yourself to desist from any att empt to decompile reverse engineer disas semble modify or derive products from the Virthos software or any part thereof to the extent that this is not authorized in the scope of this License Agreement or through provi sions of the law You are furthermore prohi bited from renting leasing loaning distribu ting or transmitting sublicenses for Virthos software of any kind that has been modified or replaced All components of the Virthos software are
6. www myserver com virthos virthos php In place of www myserver com substitute the URL of your web server If you used a different installation directory then enter the appropriate path We won t mention this any more from now on Introduction to Virthos 12 1 2006 T9 Getting Started If you entered the address correctly you will shortly see Virthos Welcome page eoe Welcome to Virthos a 1 6 4 0 Gina 7112700 1 vrthos asicz vnos cho a Welcome to Virthos installed on your web server You can now start cresting your own website To access the type a question mark and the word login behind vinhos pho in the address bar of your web Piease rapiace the standart master password by personal password To achive this open the config php fie which is found in the Viethos config directory with a text editor and follow the Nets found within that file To create you own web pages start te Virthos working environment see above bar You wil then see a bat of ail installed tornplates Choose a template and type en the Save button in the tool bar The new web page will be ceeatod Qe bution in the toot content When you are ready click As long as you do not change anything simply invoking virthos php will always result in the display of the same Welcome page You can also try some different variations Invoke Virthos with the about command Enter the following address http www mys
7. Bar click Paste The Test Page with Link that you previously cut is restored to its original position The Clipboard is then empty Introduction to Virthos 12 1 2006 41 Getting Started 42 Introduction to Virthos 12 1 2006 Licensing Licensing You may use Virthos Basic and Virthos Pro without obtaining a license key If the web server on which Virthos is installed is accessible through the IP address 127 0 0 1 or the name localhost this is unconditionally true In all other cases where Virthos is accessed through the Internet or an intranet Virthos runs in demo mode Here Virthos full functionality is available but when you start running Virthos you see an ad page To turn the demo version into a registered version you need to obtain a license key You can order this key directly from Virthos Manager if you are logged on as the master user or as a user with Administrator privileges You will find the order page in System Settings on the Licensing page More information is available in the Virthos User Guide in the chapter entitled Licensing Introduction to Virthos 12 1 2006 43 Software License Agreement Software License Agreement The following Software License Agreement is binding on all Virthos users If you use the Virthos software you declare your acceptance of this Agreement Virthos Software License Agreement Single License for One Address 1 Grant of License Virthos hereby
8. a mySQL database connection and thus provides less functional ity and fewer features than the Pro version Virthos Pro is Virthos Basic s big brother Thanks to its underlying mySQL data base it supports websites with a large number of pages which can be simultane ously edited by multiple users It contains additional features that make it possible to support more demanding web applications Where installation and operation are concerned there are but few differences between the two versions Unless specified otherwise in this manual all provisions apply to both Virthos Basic and Virthos Pro Introduction to Virthos 12 1 2006 5 Welcome to Virthos What s New in Version 2 0 For those readers who are already familiar with Virthos we present a short description of the new features in Version 2 0 User Interface The completely revamped user interface is the most significant distinction between this version and its predecessors It uses an unobtrusive shade of gray to make it easy to distinguish the interface from the pages being worked on Icons simplify navigation and uniform typography in all templates and menus make getting around easier Rapid Navigation When you start Virthos Manager all pages are immediately loaded into the navigation tree Whenever branches are expanded or collapsed the display is now updated instanta neously The sitemap is rebuilt to show the revised hierarchy when pages are deleted moved o
9. grants you a non exclusive non transferable license to use the Virthos software under the conditions set forth below in the Agreement All rights not expli citly granted to you are reserved to Virthos The intellectual property rights granted under this Agreement are exclusively those of Virthos and its licensors for Virthos soft ware and no other patents or intellectual property rights are included Only the media on which the Virthos software are recorded become your property Virthos and or its Licensor remain the owner of all property or other rights to the Virthos software The terms of this License apply equally to any software updates made available by Vir thos that replace or enhance the original software product unless such an update is provided under a separate license In such a case the terms of the new license replace these terms 2 Demo Version The Virthos software is provided without a license key as a demo version You may use the demo version on any supported computer platform in order to construct and test information systems and online applica tions and to publish them temporarily on the Internet or an intranet Publication is deemed temporary only if it does not exceed a period of 90 days Interruptions lasting less than 30 days do not extend the authori zed period The demo version can be subject to cer tain restrictions for example to the number of web pages that can be produced the number of re
10. made available as part of a package and may not be separated from the package or distributed as independent programs THE VIRTHOS SOFTWARE MAY NOT BE USED IN THE OPERATION OF OR IN CONNECTION WITH NUCLEAR POWER GENERATING FACILITIES AIRCRAFT COMMUNICATIONS SYSTEMS FOR AIR TRAFFIC CONTROL OR WITH LIVES AVING DEVICES OR OTHER EQUIPMENT IN THESE SITUATIONS A FAILURE OF THE VIRTHOS SOFTWARE MAY LEAD TO DEATH BODILY INJURY OR SERIOUS DAMAGE TO PROPERTY OR THE ENVIRONMENT 44 Introduction to Virthos 12 1 2006 Software License Agreement 5 Period of Validity This License Agreement is in effect until its termination Your rights within the scope of this License Agreement end automatically without notification from Virthos if you vio late one or more terms of this License Agre ement Upon termination of this License Agreement you are obligated to cease using the Virthos software and to destroy all copies of the Virthos software or portions thereof that are in your possession 7 Disclaimer of Warranty You confirm and expressly concur that any use of the Virthos software is at your own risk and that this risk is wholly yours as in respect to your satisfaction with its quality performance precision and cost The Vir thos software is delivered without any ass umption of liability for defects or without any warranty of any sort Virthos and its Licensor hereby disclaim any warranty or conditions in resp
11. page identified by vtName The term current page normally refers to the page currently appearing in the web browser but inside a vtLoop block each individual subpage becomes in turn the current page Introduction to Virthos 12 1 2006 Getting Started 6 Modify the content of the template After line 16 add the following line to the HTML code lt p gt see also a href Reference gt Reference lt a gt lt p gt 7 Save the modified file 8 Start Virthos Manager and navigate to the Welcome page 9 In the Tool Bar click New Page Since the Welcome page belongs to the vtStandard package at first only the templates of this package are listed 10 Click Show all packages You will then see a list of all the templates available in Virthos including the testpage html template that you have just created Virthos mastergVirthos Test Basic 2 0 irthot bus2 0 virthot phg pg 1978acg met vtworkigacebamQ re Nene cae TT a a 14 dd eo Introduction to Virthos 12 1 2006 35 Getting Started 11 Click testpage in the list You will see the entry form for the testpage htm template The form looks very similar to the one in the previous section which you used to create a new simple page In addition to the three usual text boxes Title Body and Addendum there is now a fourth field called Reference This was automatically added by Virthos because you added a new Refe
12. simple page html template which is part of the Virthos package We will now show you how to create more pages based on simple page Later on we will cover how you can create your own templates 1 Enter the URL of the Welcome page in Virthos Manager 2 In the Tool Bar click New Page You will see a list of the available templates astergVirthos Test Basic 2 0 0Jvirthos phop p 1978amp metevtworktspace amp am Q WE MN YE 3 e The list will include all templates created by Virthos Since you haven t yet created any templates on your own the list currently shows only the simple page template that we just discussed 3 Click on simple page in the list In a short time you will see the form for creating a new page based on the sim ple page template Introduction to Virthos 12 1 2006 29 Getting Started eon Virthos mastergVithos Test Basic 2 0 e i Q mp ii12709 11mthox bat Q virthos php pg 197 amp aeg met vtworugecebamQ Q gt J sansa wW Es E mm MEE O O miim _ R eae ee l oun I 4 e ms e EE prse A This form looks exactly like the one that you saw when editing the Welcome page except that the three text boxes do not yet have any contents 4 Place some content on the form Enter the following text in the fields Title Legal Body We will soon make available some legal information about our company Addendum You can leave this field empty 5
13. testpage html looks like this lt DOCTYPE HTML PUBLIC W3C DTD HTML 3 2 Final EN gt lt html gt lt head gt lt title gt vtName lt title gt lt link rel stylesheet type text css href css styles css gt lt head gt lt body gt lt p gt lt a href vtLink gt back lt a gt lt p gt lt hl gt Title lt h1 gt lt p gt Body lt p gt lt ul gt lt vtLoop gt lt li gt lt a href vtLink gt vtName lt a gt lt 1li gt lt vtEndLoop gt lt ul gt lt p gt Addendum lt p gt lt body gt lt html gt Introduction to Virthos 12 1 2006 33 Getting Started As you can see a Virthos template consists of standard HTML code enhanced with some special elements You can recognize these special elements by the double braces as for example in line 4 vtName This kind of element is called a placeholder Other elements are embedded in HTML comments as for example in line 11 lt vtLoop gt These are known as directives Braces have no special meaning in HTML they are treated by both the web server and the browser as ordinary text However when these braces are doubled they play a special role in Virthos They make it possible to include database contents in a web page repeat portions of a web page any number of times and under some conditions to activate or hide portions of a page The placeholders and directives
14. the database automatically the first time that you invoke it mysqlUser User name used by Virthos to connect to the mySQL server You may also obtain this name from your provider or administrator In a local test environment you can enter root mysqlPassword Password for the user name You will also obtain this from your provider or administrator In a local test envi ronment you need to enter the root password that you used when installing the mySQL server Introduction to Virthos 12 1 2006 T3 Installing and Uninstalling Virthos mysqlTablePrefix Prefix for the names of the tables that Virthos will be creating in the database This prefix comes into play only if the database is also used by other Virthos installations or other PHP scripts In this case you must enter a prefix that has not yet been used anywhere else Now connect to your web server The procedure depends on where your web server is located If you want to install Virthos in a test environment on your own PC you only need to find the web server s root directory on your hard drive that is the directory in which the start page usually index html or default html is located If the web server is located in a local area network connect to the network location as you normally would Please be sure that you have the correct access rights for creating directories on the web server copying files and releasing pages If you web server is hosted remote
15. the use of the Virthos software or the inability to use the Virthos software or that are connected with such inability without respect to the legal basis of such claim of liability contract unauthorized use or other even if Virthos has been made aware of the possibility of such damages In some jurisdictions a limitation of liability for personal damages incidental damages or consequent damages is not admitted In that case it is possible that this limitation does not apply to you In no case will Virthos total liability for all damages except for legally enforced liability for personal damages exceed the sum of fifty Euros 50 00 The previously enumerated provisions remain in effect even if the above mentioned legal remedy fails of its essential purpose 8 Applicable Law and Partial Invalidity This License Agreement shall be governed by and construed in accordance with the laws of the Federal Republic of Germany as it applies to contracts concluded in Germany between German nationals This License Agreement shall not be governed by the United Nations Convention on Contracts for the International Sale of Goods whose applicability to it is hereby expressly exclu ded The non applicability of particular terms of this License Agreement does not affect the validity of the remainder of the Agreement 9 Completeness This License Agreement constitutes the entire agreement between the parties in respect to the Virthos so
16. MERCHANTABILITY or APPROPRIATENESS FOR A GIVEN PUR POSE A copy of the GPL and LGPL Agre ements for Public Licenses is delivered along with the Virthos Software Introduction to Virthos 12 1 2006 45
17. add new content to Virthos make changes to websites and do much more However this would not be as easy as it sounds because it would require you to type addresses like this http www myserver com virthos virthos php pg 113 amp met view amp ses 256 amp cod 2794e3c4e2 amp act create amp tem plate news This command would create a new web page based on the news html template subor dinate to page 113 in the Virthos hierarchy Fortunately you will not need to type strings like this because Virthos Manager provides an environment in which the same results are obtained by simple mouse clicks For security reasons this area is only available to users who have logged on to Virthos with a special password 1 Enter the URL of the Virthos login page If you would like to review how to do this please go back to the last section 2 Enter your user name and password In Virthos Basic the user name is set to master whereas in the Pro version you can decide on your own user name However if you have not yet selected your own user name you must use the user name master Enter the password included in the config php configuration file as your password If you used the Online Installation Program this would be the same password that you used for FTP access to the web server If you installed Virthos manually and did not change anything the password would be demo For security reasons the password is not shown when you enter it You will
18. e Web you may find yourself putting together many pages that in the end you will decide not to use That s why Virthos makes it easy to dispose of pages that you no longer need Take the Legal page that we created in the last section 1 Use Virthos Manager to open the Legal page If you haven t yet started Virthos Manager log on to Virthos On the Welcome page click the Legal item The page is displayed eon Virthos masterfiVirthos Test Basic 2 0 lt gt c gt Ge 919 127 0 0 1 vethos basic 0 vires phe pg 197 amp amo metevtwortspace amp am Q newer centem I nme 00 Nimm NS ts ee ew e Legal We wil soon maka ava atie some lag information about our company o z B e U mma Got Gam cone naiaren 2 In the Tool Bar click Put in Trash To make sure that is really what you want to do you will be asked to confirm your choice http 127 0 0 1 Do you want to put the selected page s in the trash Abbrechen ok Virthos uses a trash can icon just like many operating systems to let you dispose of pages that you no longer want This is a kind of trial deletion If you later decide that you really do still need the page you can get it back from the trash can 38 Introduction to Virthos 12 1 2006 Getting Started Click OK The Legal page is moved to the trash can and you again see the Welcome page The link to Legal disappears because it is no longer a
19. e to sign on to FTP with a password that allows you to write to the web server s hard drive If you meet all these requirements then you can use the Online Installation Program available at www virthos net services installer Just follow the instructions on the screen If your installation is successful you will see a message to that effect in your browser window Close the window and continue as detailed under Testing Your Installation Since there are many different types of servers and it is impossible to test with all of them there is a chance that the online installation may encounter some difficulties In that case one or more warning messages will appear in your browser window at the end of the installation You may then perform a manual installation as described in the next section Please note The FTP and mySQL access information that you provide during the online installation process are retained only for the duration of the installation process and are deleted immediately afterward There is the hypothetical possibility that unauthorized persons may intercept this information while it is being transmitted To provide greater security you may want to change these passwords after concluding the installation Introduction to Virthos 12 1 2006 Installing and Uninstalling Virthos Manual Installation To install Virthos on a web server manually proceed as follows 1 Copy the Virthos instal
20. ect to the Virthos software including any expressed implied or legally provided warranties especially any implicit warranties and or conditions for its merchantability satisfactory quality acceptability for its inten ded purpose precision undisturbed use or protection of the rights of third parties Virthos disclaims any warranty arising from claims that the undisturbed use of the Virthos software has been impaired that the functionality of the Virthos software does not fulfill your expectations that the operation of the Virthos software is free of defects or that deficiencies in the Virthos software will be corrected Any oral or written statement or declaration on the part of Virthos or an authorized Virthos representative do not imply that any warranty has been given If the Virthos software should prove defective you assume all expenses for any needed service calls repairs or corrections Some provisions of the law do not permit the exclu sion of implied warranties or limitation of the executable legal rights of a customer so that the above mentioned exclusions and restrictions may not be applicable in your case 7 Limitation of Liability To the extent not prohibited by law Virthos is in no way liable for personal injury or inci dental specific indirect or consequent damages of any sort especially including lost income data loss interruption of busi ness or other commercial damages or los ses that arise from
21. elect Editing Mode In the Mode Selector click Edit You will then see an editing form in the Content Area eoe Virthos mastergVirthos Test Basic 2 0 0 mets 1127 00 1 iehos bane Ojvirhos php pg 197 amp amp met vreorkipacellamiQ Q Ww gt t This form consists of three input fields Title Body and Addendum The Addendum field will be empty The two other fields contain the contents of the Welcome page 4 Modify the title Overtype the current text in the Title field with something else For example you might key in Welcome to my home page Introduction to Virthos 12 1 2006 27 Getting Started 5 Save your changes In the Tool Bar click Save In a few seconds you will see the Welcome page displayed again with the new text 6 Now change the body text of the Welcome page Click Edit again overtype the text currently in the Body field and click Save You will see the modified Welcome page appear in the Content Area If you don t like the result click Edit again and make some more modifications 28 Introduction to Virthos 12 1 2006 Getting Started Creating New Pages It is just as easy to create new pages with Virthos as it is to change their contents Every page in Virthos must be based on a template that was previously created with an HTML editor or a web design application For example the Welcome page used as an example in the previous section is based on the
22. erver com virthos virthos php about In this example we have just added a question mark and the word about This will result in the following display in your browser About Virthos Basic veso 103 tute 77 Entering the about command will give you some information about the current Virthos installation most notably the version number You will also find a link to the website of Virthos Systems GmbH where you will find more information updates and technical support 20 Introduction to Virthos 12 1 2006 Getting Started Invoke Virthos with the login command By now you probably already know what to do Enter the following address http www myserver com virthos virthos php login In this example about has been replaced by login This will result in the following display in your browser eon Virthos login at Virthos Test Basic 2 0 6 Q nto 127 0 0 1 vethos basic2 0jvirthos phpniogin 4 This is Virthos Login window which lets you access Virthos Manager the central tool for managing a website with Virthos More about this in the next section Introduction to Virthos 12 1 2006 21 Getting Started Starting and Stopping Virthos Manager In the last section you learned how to access specific web pages by including additional information in the URL when you call Virthos We gave you only a few simple examples In theory by furnishing even more information you could also
23. ftware licensed through the Agreement and supersedes any prior oral or written agreements Any modifi cations and additions to this Agreement must be made in writing Any translation of the License Agreement serves only for pur poses of product localization In the event of a discrepancy between the German version and a non German version the terms of the German version shall apply 10 Acknowledgment of Rights of Third Parties Parts of the Virthos software use or contain software or other protected intellectual pro perty of third parties The acknowledgment licensing terms and provisions for compen sation of damages for these materials are contained in the Virthos software and the use of these materials is subject to the perti nent terms In the case of certain libraries and other software programs of third party providers delivered along with the Virthos software the software may be free software licensed under the terms of the GNU Library General Public License Version 2 GPL or the GNU Library Lesser General Public License LGPL You may obtain a complete machine readable copy of the source code for this free software under the provisions of the GPL or LGPL upon written request to Virthos without charge except for a defrayal of the costs of media shipping and hand ling The GPL LGPL software is distributed with the expectation that it will be helpful but WITHOUT ANY WARRANTY including any warranty for
24. gistered users or the number of language versions permitted Moreover the demo version may under certain conditi ons include text banner or word and image advertising for the products of Virthos or other parties You are not allowed to make any attempt to suppress these advertising displays or to make them invisible to users You may not sell loan or lease the demo version nor grant sublicenses for the Virthos software 3 Registered Version By payment of a license fee you may con vert the demo version to a registered ver sion This process is technically accomplis hed by entering a license key that you receive from Virthos Systems after payment of the license fee Entering the license key eliminates all restrictions of the demo ver sion and carries with it the right to make available information systems and online applications for an unlimited period of time When paying the license fee you must indi cate the network address where the registe red version is to be made available The license key is valid exclusively for this address If you provide an invalid address the demo version cannot be converted to the registered version You have no right to exchange an invalid license key for a valid one if such invalidity results from entering an incorrect address If the network address where Virthos soft ware is made available should become inva lid in the future the registered version will again convert to a demo version
25. he installation and determine if you have successfully installed Virthos proceed as follows 1 Execute the Virthos script in your browser Enter the following address http www myserver com virthos virthos php Replace www myserver com with the address of your web server for local access use 127 0 0 1 or localhost If you did not install Virthos in your web server s root directory after the server address include the path to the installation directory Please note If the web server is located on your own computer you cannot simply open the file virthos php in your browser which would be the equivalent of entering an address beginning with ile You must access the web server using http as described above 1 If your installation was successful after entering the correct address in your browser you will see Virthos Login window j Name master Password E Log In If you see an error message instead of or in addition to the Login window please verify that you have entered the correct address you have made sure that all the permissions are correct m your web server meets all the requirements f you have installed the Pro Version Is the mySQL access information in the config php file correct Please correct any mistakes and try again If after reviewing everything you still have problems please contact Virthos Customer Service You can get more information on the Virthos webs
26. ing Virthos Manager for a while it will automati cally log you off one hour after your last access When you subsequently restart Virthos Manager you will again be asked for your password If one hour seems like too much time or not enough you can change this interval in your System Settings More informa tion on this topic can be found in the Virthos User Manual Introduction to Virthos 12 1 2006 25 Getting Started Changing the Master Password The master password allows unlimited access to all Virthos content and should therefore be closely safeguarded It should be at least 8 characters long and include uppercase and lowercase letters as well as numerals and punctuation marks If you have already created a password that meets these requirements you can skip the rest of this section Otherwise you should follow these directions carefully to prevent unauthorized persons from accessing your Virthos system Please proceed as follows 1 Find the Virthos configuration file The master password along with some other System Settings is stored in a file named config php located in the Virthos config subdirectory This is a simple text file that can be opened and edited with any text editor If you are running Virthos in a test environment on your own computer you will find the configuration file in that subdirectory on your own web server and you can edit it there directly If you installed Virthos on an external web server yo
27. ing and Uninstalling Virthos This ends the manual installation process To determine whether you have done every thing correctly please follow the instructions under Testing the Installation Please note If PHP is installed on the web server as a CGI module and not as an integrated server module you must use a text editor to add a line at the beginning of the virthos php file with the address of the PHP interpreter for example usr local bin php If this provision applies to you you must ask your provider or consult the documentation for your version of PHP to find out exactly how to construct this line Please take care in particular to code line breaks in the PHP file correctly Most web servers prefer that line breaks be coded for Unix files Therefore if you code the line in Windows or Mac OS Classic you should use a text editor that allows you to specify Unix line breaks Another option is to use an FTP program that allows you to convert line breaks while uploading a file Many web servers are configured so that all PHP scripts must be located in a specified directory such as cgi bin which may not contain any image files or other resources If this applies to you you must alter Virthos default directory structure This process is explained in the Virthos User Manual Introduction to Virthos 12 1 2006 15 Installing and Uninstalling Virthos Concluding and Testing the Installation To conclude t
28. ite www virthos net in the Support area 16 Introduction to Virthos 12 1 2006 Installing and Uninstalling Virthos 2 Enter the master password The first time Virthos runs it must perform some basic operations for example in the Pro version it must set up the mySQL database For security reasons only the master user can do this Enter the master password that is stored in the config php file If you used the Online Installation Program the master password is the same as the FTP password that you used during the installation If you installed Virthos manually and did not change anything the password would be demo 3 Click the Login button If the installation was successful you should see the Virthos License Agreement on your screen within a few seconds Then go on to the next step If you see an error message instead of the License Agreement please verify that the mySQL access information in the config php configuration file in the config directory is correct there are not already tables belonging to another Virthos installation with the same prefix in the database the mySQL user you have specified has the right to create new database tables If necessary correct any entries you have made in the configuration file and make sure that mySQL server complies with all requirements Then start over at Step 1 4 Declare your acceptance of the License Agreement Please read this agreement carefully If
29. lation package to your hard drive You may either copy the installation package from the Virthos CD or download it Downloads area on www virthos net If you download the package it will come as a compressed Zip file which you must first unzip This will create a directory named virthos on your hard drive containing the file virthos php and four subdirec tories named config data system and templates 2 Next customize the configuration file Open the config php file which can be found in the config subdirectory of the virthos directory with a text editor This file contains a series of basic settings that Virthos requires The meaning of the particular settings is thoroughly documented within the file For security reasons it is advisable to change the default master password to a new one In addition for the Pro version it is essential to enter the mySQL access data The following chart will help you determine the correct values mysqlServer Address of the mySQL server In many cases especially when a test environment has been set up on your own computer it is sufficient to enter localhost or 127 0 0 1 which has the same meaning mysqlDatabase Name of the mySQL database You may obtain this name from your hosting provider or administrator when you request or create a new database If you are working in a local test environment and have the authority to create a new database you can enter any name here Virthos will create
30. lation time and all its subdirectories and files can be deleted If you use FTP to access the web server be sure to log in with the same user name that you used at installation time in order to ensure that you will have the needed permissions for deleting data This ends the uninstall process 18 Introduction to Virthos 12 1 2006 Getting Started Getting Started Before you jump in and try Virthos for yourself we d like to suggest that that you try a few things to get an idea of how it works The following provides a systematic introduction that should be taken step by step There is one thing you can be sure of the time you spend to go through it now will be paid back many times later because you will under stand how everything fits together and know where to look up what you need to know Accessing Web Pages The core of Virthos functionality lies in a file by the name of virthos php usually found in the virthos directory on the web server This is a so called PHP script meaning a computer program that is executed on the server and that can create web pages according to preset rules The PHP script that you invoke determines what kind of web page will be delivered to the browser Here are a few examples to make this clear 1 Invoke Virthos in your browser You have probably already done this after you finished installing Virthos to see if everything worked Please do it again now Enter the following address http
31. ly use an FTP program to establish the connection In this case too please make sure that you log in with a name that gives you the necessary rights Copy the Virthos directory to your web server Copy the virthos directory with all of its contents see Step 1 to the root directory of the web server the one in which the start page usually index html or default htm is located You can also copy Virthos into any subdirectory of the root directory Verify and correct the permissions of the directories and files that you have copied The files and directories that you copy to the web server automatically acquire certain permissions What these are depends on how you have connected to the web server and what operating system it is running on On Unix systems especially including Linux and Mac OS X if you have not set the permissions correctly Virthos functionality can be adversely affected Therefore please be sure that All files and directories that you copy must be readable by all users This corres ponds to the Unix command chmod with a value of 744 The file virthos php as well as any directories you create must be readable and executable for all users chmod 755 This is not required for all servers but it cannot hurt in any case The data directory and all the files and subdirectories contained within it must be alterable and executable for all users chmod 777 14 Introduction to Virthos 12 1 2006 Install
32. ng the simple page html template which you used in the previous section The package also holds the CSS style sheet file used by the template Introduction to Virthos 12 1 2006 Getting Started a AeA U Nc oO NO 11 12 13 14 15 16 17 18 Create a new subdirectory in the templates directory Name the new directory first_test You can choose almost any name for a template package but it cannot contain any accented characters spaces punctuation marks or special characters except for hyphens and underscores Copy the contents of the vtStandard directory into the new subdirectory To keep things simple we will not be building any new templates from the ground up We will just modify an already existing template In order to save the existing file simple page html as it is we will be working with a copy located in the new first test package Rename the copy to testpage html You can also choose almost any name for a template but here too the limitation applies that it cannot contain any accented characters spaces punctuation or special characters except for hyphens and underscores Open the testpage htm file with a text editor or HTML editor It does not matter what kind of software you use Virthos templates can be created and edited with any program that offers full support for HTML Since these programs can differ greatly the following descriptions apply to a simple HTML editor The source code of
33. ntered on the keyboard talics are used for text that appears on the screen such as the names of files and directories the names of buttons that can be clicked appear in square brackets Representation of Images Illustrations of web pages and entry forms in this manual are as they appear in the Safari web browser on a Mac OS X system If you use another browser or operating system you may see a slightly different representation In any case the descriptions are still valid Please note A box such as this one indicates important instructions that should not be overlooked 1 Introduction to Virthos 12 1 2006 7 About This Manual 8 Introduction to Virthos 12 1 2006 Installation Requirements Installation Requirements Web Server Requirements Virthos Pro runs as a so called PHP script on the web server the computer that serves the HTML pages for a website It does not matter if you are running the web server yourself or if it is located on space made available to you on your provider s computer The important thing is that server meets the following requirements Support for PHP 4 1 or a higher version Access to a mySQL database not applicable to Virthos Basic Access to the file system by FTP or other means with the capability of modifying permissions About 2 MB of available memory Virthos does not require any special PHP libraries Any standard PHP installation is sufficient
34. ntroduction to Virthos 12 1 2006 23 Getting Started 4 In the Mode Selector click the Virthos logo at the right This will display the same page that you saw before by entering the about command eoe Viethos mastergVirthos Test Basic 2 0 a e Q 9m 127 00 1 vethosbatic2 onsa phe pg 197 amp amo mer vwerkspaceliamv Q CJ eun w E i nm NG orem ice Ma suce gih seonocos gum Otai 00 About Virthos Basic a EE Ir al To see the Welcome page again click Preview on the Mode Selector at the far left We will discuss the purpose of the remaining buttons and how to use the Navigation Bar later 5 Inthe Status Area click Log Out Logging off means that you are ending your session and leaving Virthos Manager Virthos asks for a confirmation to ensure that you really want to log off http 127 0 0 1 Are you sure that you want to end your Virthos session Abbrechen Cox 6 Click OK Virthos Manager closes and you again see the Login page in your browser window 24 Introduction to Virthos 12 1 2006 Getting Started Please note If you do not log off as just described but just close your browser window in Virthos Manager someone could just come along and press the Back button to return to it without being asked for a password By logging off as described you will prevent this from happening If you forget to log off or if you stop us
35. pages or PHP scripts that are already on the web server will not be affected by the installation of Virthos Pro There is absolutely no interaction between the content and functionality made available through Virthos and the existing website If desired the Virthos installation can also be easily backed out Please note Virthos Pro will create some new tables in the mySQL database and if tables with the same names already exist their contents will most likely be deleted In order to pre vent something like this from happening and to make it possible to run several copies of Virthos on the same machine Virthos lets you specify various prefixes of your own choosing Normally each mySQL table that Virthos installs carries the pre fix vt2 If your database already contains tables starting with this character string you should specify a different string when configuring Virthos Introduction to Virthos 12 1 2006 11 Installing and Uninstalling Virthos Using the Online Installation Program The quickest way to install Virthos on a web server is to user the Online Installation Program There are just a few requirements for using it The web server on which you install Virthos must have a public IP address either numeric like 192 32 226 11 or a symbolic one like ftp mysite com The web server must be accessible by FTP This means that it cannot be behind a firewall that blocks FTP access You must be abl
36. r renamed Clipboard The new Clipboard facilitates moving and copying of pages as well as the introduction of links The needed tools are made available in both Preview and Structured view so that you can work either on the current page alone or all its subordinate pages at the same time 6 Introduction to Virthos 12 1 2006 About This Manual About This Manual This manual is intended to let you start using Virthos quickly and to give you a short overview of how it works There are several other sources that can provide you with additional information Virthos User Guide The comprehensive guide to all aspects of Virthos It is intended for webmasters web designers and authors VirthosTalk Reference Guide The detailed guide to all placeholders and directives available for creating Virthos Templates Online Resources The Virthos website www virthos net provides additional sources of information and sample files for downloading Virthos Basic Virthos Pro Virthos is available in two versions Virthos Basic and Virthos Pro This manual applies to both versions Any material that pertains to only one or the other version will be clearly indicated Font Usage Several different types of text are used in this manual in an effort to make clear how certain expressions are used Bold type is used to indicate steps to be carried out in order to accomplish a task Monospace type is used for text to be e
37. rence placeholder to the original template 12 Fill out the form Right now you should be concerned only with understanding the basic way in which Virthos works so it does not really matter what you enter on the form Here is a suggestion Title Test Page with Link Body Virthos makes web publishing easy Addendum And it also makes it fun Reference http www virthos net 36 Introduction to Virthos 12 1 2006 Getting Started 13 In the Tool Bar click Save A new page is created and displayed in the Content Area eon Vinhos mastergVirthos Test Basic 2 0 4 il amp l 4M 0051 127 0 0 Mno basc 0 virthos pho pg 197 amp amp met vtworkspace amp amQ Q Test Page with Link Vianos makes web publishing oasy And it also makos it fur su also tip ww erate cave Ve Ow Ml secum Se dua e Notice how the new Reference placeholder is used in two ways It appears as visible text and also as the not visible target of the hyperlink Take a look at the source code too 14 Click the Back hyperlink above the title You again see the Welcome page As we have mentioned before the simple page template contains a vtLoop loop which is used to build a list of all subpages This is why the Test Page with Link is now listed Introduction to Virthos 12 1 2006 Sd Getting Started Deleting Pages Especially at the beginning of the process of creating your presence on th
38. see a period in place of each character you enter instead 3 Click Log in or press the return key If you enter the name and password case sensitive correctly you will see Virthos Manager in your browser window This may take several seconds 22 Introduction to Virthos 12 1 2006 Getting Started 3 Virthos Manager is divided into five regions 1 Header Area 2 Navigation Bar 3 Mode Selector 4 Content Area 5 Tool Bar This shows the name of the currently selected page bold a list of parent pages path the user name that you used to log in and a button for logging out In the Pro version you will also see a language selection menu This displays a tree view of the pages managed by Virthos The currently selected page is shown in a darker color By clicking the gray triangle you can change the view to include or exclude subordinate pages At the very bottom are buttons to take you to User Administration and System Settings This lets you choose between the various modes Also on the right side of the screen you can invoke a list of additional functions or show information about the current version of the Virthos application Depending on the mode that you are working in you will see either the actual page content or a form created by Virthos for editing the current page or changing its properties This shows a variety of available tools depending on what is currently in the Content Area I
39. ssume building a new template becomes a simple matter Please note The follow description assumes that you have installed your web server and Virthos on your own computer and that you can access the Virthos directory directly Should this not be the case then you will have to complete these steps using a local copy of the Virthos directory and later synchronize them with the web server on which Virthos is installed 1 Open the templates directory All the templates are located in the templates directory which is in the Virthos root directory that is the directory in which the virthos php file is also located When you open the directory you should see a list of its contents On a Mac OS X system this could look like this eoo beta c F Name gt L config gt 3 data gt system v templates v F wtStandard gt LS css simple_page html virthos php The templates directory is where all the templates that are available to Virthos are stored Templates are normally not placed directly in the templates directory but rather in subdirectories which are commonly known as packages Each package may consist of any number of templates and also its associated images JavaScript files style descriptions etc After your installation the templates directory at first contains only one package named vtStandard containi
40. subpage of the Welcome page Click Trash in the Navigation pane on the left The Trash page is displayed In Preview Mode you only see how many pages are in the trash but not which ones To find out go to the next step In the Mode Selector click Structured You will see the contents of the trash can listed The so called Structured view shows all the pages that are subordinate to the currently selected page It will tell you which template each page is based on when it was created and when it was last modified This is true not only for the trash can but also for every other page that your create in Virthos Finally open the Preview again Click Preview in the Mode Selector Introduction to Virthos 12 1 2006 39 Getting Started Moving Pages In the previous section you saw how you can put pages in the trash Now you will see how you can move any page anywhere within the Virthos hierarchy and also how you can return a page in the Trash to its original location 1 Use Virthos Manager to bring up the Test Page with Link that you created in the second to last section eon Virthos mastergVirthos Test Basic 2 0 4 1 61 A O0 127 00 1 virthotibase2 0 virthos pho pq 197 amp amp met viwo kspace amp amiQ Q D Test Page wan Linie wer Mime cave Ve Ow Unmem 0000 Nj eme UM cs WE n Asl Test Page with Link Vianos makes web putis irg oasy And it aiso makes it fun
41. tit etie rete Hr ie heir Reve Pera 44 Introduction to Virthos 12 1 2006 3 Table of Contents 4 Introduction to Virthos 12 1 2006 Welcome to Virthos Welcome to Virthos Virthos is a software product that simplifies the development of web applications For any kind of web page from a guestbook to an online store from simple text files to a compre hensive workflow and collaboration management system Virthos makes it easy to develop applications without any previous knowledge of programming or databases Its principal use is for what is commonly referred to as web content management the management of text and media content for the Internet Its goal is to enable staff with no knowledge of HTML or website design to manage web pages in order to reduce costs and to ensure that content can easily be kept up to date Virthos is installed on your current web server and allows your server to run a variety of applications It does this in the same way that a PC operating system allows a variety of word processing and graphics programs to be run concurrently Just as the OS provides a common platform for all the applications software on your PC Virthos acts as indepen dent platform for web applications of all sorts Virthos comes in two Versions m Virthos Basic is our entry level product designed for uncomplicated sites that require content management and that run simple web applications Virthos Basic functions without
42. u will need to download the configuration file using an FTP program 2 Open the configuration file with a text editor Be sure to use an editor designed for HTML or PHP files that will not introduce any invisible formatting characters into the text 3 Find the line to be modified Every line in the configuration file that does not begin with a semicolon contains a particular system setting Look for a line beginning with masterPassword 4 Change the password to whatever you wish Overtype the password with another one that meets the requirements given above 5 Close and save the configuration file Use the text editor s Save command and close the file If you installed Virthos on a remote web server use your FTP program to upload the file and replace the configu ration file located there 26 Introduction to Virthos 12 1 2006 Getting Started Editing Content Once you have learned the basics of how Virthos works you can start using it to make content changes on your website We will start with some minor modifications to the text on the Welcome page 1 Start Virthos Manager in your browser This process is described in the previous section Be sure to use the password that you set in the last section 2 Navigate to the Welcome page If you do not see the Welcome page displayed automatically click on Welcome in the Navigation Bar on the left The Welcome page will appear in the Virthos Manager Content Area 3 S
43. understood by Virthos comprise a separate language known as VirthosTalk which extends the capabilities of HTML and similar descrip tive languages The available placeholders and directives are thoroughly doc umented in the VirthosTalk Reference which can be downloaded from the Virthos website But don t panic When starting out you need only a handful of language elements that you will quickly learn At this point we do not want to bother you with details of VirthosTalk but we would like to just mention some of the distinctive features of the simple page template The Title line 8 Body Line 9 and Addendum Line 15 placeholders are so called user placeholders This means that they can be named anything that the web designer wishes They could just as well have been called Headline Content and Content2 User placeholders are used to define the editable areas of a template The block from line 11 to line 13 vtLoop vtEndLoop defines an area that is repeated multiple times namely once for each page that is subor dinate to the current page Subordinate pages are called subpages in Virthos This loop is the reason why a link from the Welcome page to the Legal page that you created was automatically displayed The vtLink and vtName placeholders are predefined placeholders distinguished by the fact that they begin with vt The expression vtLink creates a URL pointing to the current
44. you cannot agree to any of the terms you cannot use Virthos Otherwise click the button that signifies your acceptance of the terms of the Agreement and then Continue After you accept the Agreement you will see Virthos Manager in your browser window Close this window for now Continue as detailed in the chapter Getting Started Introduction to Virthos 12 1 2006 17 Installing and Uninstalling Virthos Uninstalling If you should decide not to use Virthos anymore just delete all the directories and files from your web server Any pages on your website that were not created by Virthos or linked to a Virthos page will continue to display as usual Please note When you uninstall Virthos any content that you have created with Virthos and all templates in the templates directory will be deleted To be safe make backup copies of all files before uninstalling Virthos 4 To remove Virthos from your web server proceed as follows 1 Drop any mySQL database tables that you no longer need The following applies only to Virthos Pro Point your web browser to the virthos php file with the dbdestroy command http virthos php dbdestroy Enter the master password in the window that appears and click Drop Database This will cause any tables created by Virthos at installation time and afterwards to be dropped from the mySQL database 2 Delete the installation directory The virthos directory created at instal
Download Pdf Manuals
Related Search