MBS Xojo Web Starter Kit
MBS Xojo Web Starter Kit
Version 1.2, © 2012-2017 by Christian Schmitz, Monkeybread Software
About the MBS Xojo Web Starter Kit
3
Features
3
About Database Access
3
Version History
4
Web App Tips
5
Screenshots
6
Installation
14
Demo
15
Requirements
16
License
17
Contact
18
About the MBS Xojo Web Starter Kit
Our Kit provides you with a start project for your own Web projects.
Features
• Database Support including REALSQLDatabase, MySQLCommunityServer,
CubeSQLServer and SQLDatabaseMBS.
• Simple User Management for Admins and normal users.
• Login Panel
• Auto login, so people don‘t need to login each time.
• Collects Exceptions and JavaScript Errors in database and displays them to Admin.
• Allows logging to text file and database and displaying them.
• SQL Console with download of database and query result as CSV file.
• Session management for admin to see what users do.
• Chat Window
• Creates Backup of database.
• Object browser and memory statistics
• Messages for Admins to/from users.
• File Browser
• Shows how to cache images/files to save memory.
• and much more…
About Database Access
Database Support included for REALSQLDatabase and MySQLCommunityServer plugin
from Real Software. Also you can use CubeSQLServer Plugin from sqlabs. And you can
use MBS SQL Plugin for connecting to various servers. Example code is included for using
SQLite and MySQL using SQLDatabaseMBS class.
See Database Module for constants to turn on/off the database access using various
ways. By default UseRealSQLDatabase is true to use a local database.
You can turn UseRealSQLDatabase to false and instead set UseCubeSQLServer,
UseMySQLDatabase or UseMBSSQLDatabase to true. Check in the Open methods there
that the connection strings, usernames and passwords are correct.
Version History
Tip: If you want to update your existing code with new release, you‘d best compare
projects with Arbed (http://www.tempel.org/Arbed) and copy modifications to new project.
1.2
• Added helper functions for WebPopupMenu
• Fixed some back buttons.
• Added low level exception/signal handling classes from Bug Reporter Kit.
• Changed code because some App.File* functions which are not available in newer Xojo
versions.
• Renamed Hash Function to not conflict with hash function in other Web components.
• Updated for Xojo 2017.
1.1, 1st October 2013
• Added Web Signature Kit project.
• Commented out Print commands. They are useful in standalone, but cause problems in
cgi mode.
• Improved code to handle database. Now the app launches when no database is found.
• Added WebLoadBalancing example code
• Added System Information page.
1.0, first release
Web App Tips
• Use Prepared Statements for Database Access. Never pass data from outside app
directly to SQL engine. There may be an SQL injection.
• Don‘t show database errors to user. They may learn how your database is organized.
• In buttons only visible for admin, verify if user is admin. Hackers may have injected an
event for an invisible button.
• Always check database.error in your code.
• Don‘t store passwords in clear text. Also use salted hashes.
• Don‘t store clear text in cookies. Always some random ID with data in database.
• Make sure via .htaccess on server that people can‘t download application, config file or
plugin libraries.
Screenshots
The login page:
After login as admin you see this page with your control options:
The user management page:
We have a chat system ready for you:
You can see all sessions currently active in our sessions page:
The admin can review all javascript errors the user saw:
and see all exceptions:
You can read the log entries in the database:
And use the SQL console to browse the database and export results:
The object inspector shows you what objects are in memory:
with details on each object:
The File browser shows files on the server and allows you to upload, download and
change permissions:
On the messages system, users can send messages with a little panel:
And as Admin you can see those messages on the messages page:
And as admin the messages pop up and you can answer them:
Installation
Please build the project and install like any normal web app on your server.
On the Server, make the folder writeable, so we can write our log files.
The webstarterkit.cgi and the WebStarterKit files should have executable flag set (chmod
755). Config and database files must be writable.
Demo
The demo web app can be seen here:
http://webapps.monkeybreadsoftware.de/WebStarterKit/webstarterkit.cgi
The database is a memory copy and reset everytime the web app restarts (after all
sessions ended). You are not allowed to drop tables or delete/modify the admin user.
Requirements
You need Xojo 2013r1 or newer.
We recommend you get a Complete license for the MBS Xojo Plugins.
Some plugins are required like the Util plugin. Also recommended are the Linux plugin,
Mac OS X plugin and Win plugin.
License
Summary:
• You may use Web Starter Kit only with one licensed Xojo installation.
• You agree not to share the Web Starter Kit or use someone else's Web Starter Kit copy.
• You can of course use parts or all of the code in your own products.
Christian Schmitz Software GmbH, of Nickenich Germany is the owner, developer and
sole copyright holder of this product, which is licensed -not sold- to you on a non-exclusive
basis.
You agree not to share your MBS Xojo Web Starter Kit with anyone.
You may transfer your license to another person only after receiving written authorization
from Christian Schmitz Software GmbH and only if the recipient agrees to be bound by the
terms of this agreement.
Christian Schmitz Software GmbH reserves the right to cancel the license key(s) of any
user who Christian Schmitz Software GmbH determines is in violation of this agreement.
THE WARRANTIES IN THIS AGREEMENT REPLACE ALL OTHER WARRANTIES,
EXPRESS OR IMPLIED, INCLUDING ANY WARRANTIES OF MERCHANTABILITY OR
FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE IS PROVIDED "AS IS"
AND Christian Schmitz Software GmbH DISCLAIMS AND EXCLUDES ALL OTHER
WARRANTIES. IN NO EVENT WILL Christian Schmitz Software GmbH BE LIABLE FOR
ANY SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES, INCLUDING LOST
PROFITS, EVEN IF WE HAVE KNOWLEDGE OF THE POTIENTIAL LOSS OR DAMAGE.
If you are located in Germany this agreement is subject to the laws of Germany. If you are
located outside Germany local law may apply. Some states do not allow the exclusion of
warranties, so the above exclusion may not apply to you.
Christian Schmitz Software GmbH does not charge royalties or deployment fees for Xojo
applications.
Access to updates is included for one year. After that time you can order an update or
keep using the old version you have.
Contact
Christian Schmitz Software GmbH
Eckertshohl 22
56645 Nickenich
Germany
Email: [email protected]
Phone: +49 26 32 95 89 55 (Office) or +49 17 58 36 37 10 (Mobile)
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertisement