Please read this document if you're installing Web Connection for the first time or even if you are doing an update installation. It contains important information that might save you some trouble during installation and especially during updates.
- Windows 10, 8, 7, Vista, 2016, 2012, 2008, 2003
- Windows Web Server IIS 7 or later, IIS Express, IIS 6
- Visual FoxPro 9.0
Extracting the Self Extracting Zip Archive
You can download the shareware version of Web Connection from a public link, while the full version download link is provided to you via a registration email. The shareware version is named
wconnect.exe, the registered version is named
These files are self-executing Zip archives and can be executed as an EXE with prompts where to install. Alternately, the EXE can be opened with your favorite Zip utility (ie. 7zip and WinZip) and extracted using your tool at which point you can pick out individual files.
Open up Explorer in
c:\wconnect (or whereever extracted to) and execute
Setup.exe, which installs or updates Web Connection. If you are updating from an existing version you can decide whether to re-run setup to configure and update the samples, or simply unzip the Exe file directly into the existing installation.
IIS has to be already installed
If you plan to use IIS for development, IIS has to be installed and properly configured before you install Web Connection. IIS is an optional Windows Component and you have to explicitly install it. There are detailed instructions on how to configure IIS in the documentation. Optionally you can also use IIS Express which does not require any explicit configuration or Admin rights to run.
First Time or Update Installation
Setup.exe from the install directory and just accept all the prompts. There are detailed instructions on what the Setup program does and how to get started. This will install the sample Web folders, set permissions and get the samples ready for you to play and check out Web Connection in operation.
No FoxPro Runtimes?
If you do not have the VFP runtime files installed you can also run the appropriate Setup.exe file from within Visual FoxPro. Start Visual FoxPro and CD
then DO SETUP.exe to launch setup from within VFP. Make sure you use Run As Administrator as configuration features require full admin access.
If you want to install a full version of IIS on Desktop or Server versions of Windows we've provided a Powershell script to enable all the Web server features required to run Web Connection.
To install IIS on your Windows machine:
Open an Administrator Powershell Command Prompt and type:
PS> cd \wconnect PS> .\Install-IIS-Featured.ps1
You can also install those same features manually using Add Windows Features (Desktop) or Add Server Roles (Server).
Updating an existing Installation
If you are updating an existing installation, running
Setup.exe is optional, but still recommended. You'll want to re-run setup on your existing installation on major updates to insure the latest example files are installed and hooked up.
If you do it's recommended you choose the same setup directories as in the previous installation.
Don't change Web Connection Files!
If you changed any of the sample files or Web Connection classes installed, the changes will be overwritten. Hopefully you wrote code in your own files and sub-classes.
Always create new projects to work on, or copy the samples to a new location, never use the samples directly for your own code. If you need to make changes to framework classes subclass them in a separate folder or as part of your application, rather than changing the original classes as they will be overwritten by updates.
Upgrading from the Shareware Version
To upgrade from the shareware version you can simply install Web Connection either to a new directory or on top of your shareware installation. If you install on top of an existing installation simply unzip the distribution files into the original directory.
When upgrading from the shareware version it's important that you delete wconnect.app, which holds most of the Web Connection class libraries for the shareware version. In the release version those libraries are replaced with the actual source code classes in the
DELETE FILE wconnect.app
Recompile your classes!
If you are updating an existing install or are not installing under VFP 9.0 you should first recompile all of the Web Connection classes to ensure you get the latest code and properly compiled compiled code for your version of FoxPro.
To do so, start Web Connection in its install directory and do:
COMPILE *.prg COMPILE CLASSES\*.prg COMPILE CLASSLIB CLASSES\*.vcx
The installed folder contains the base Web Connection installation which contains the Console application and sample server and Web sample pages that demonstrate how Web Connection works.
The Console application is the hub for Web Connection's administration features that allow you to create new projects or add functionality to existing projects as well as add new features and functionality. The bulk of the files installed are templates base files that are used to create new projects or new files.
The install also creates a sample Web Connection server and a number of corresponding Web samples which you can run and examine to see how Web Connection works.
There's a feature sample that shows many of the core features of Web Connection in very simple task based examples. Then there are a host of example applications that demonstrate a number of different approaches to building more complex Web Connection applications. The examples include a Weblog, a Message Board, a AngularJS client side AlbumViewer example.
If you get stuck
If you run into problems with your installation or getting started there are a few resources available.
The online documentation is extensive and provides a lot of useful information. Most tasks have walk throughs that you can check out to understand a feature or process. The documentation is available both online as well as in the Help File. Both are searchable so you can find what you're looking for.
- Online Documentation
- The Help File lives in wconnect.chm in your install folder
West Wind Message Board Support Forum
We have a message board that you can use to post questions and get answers to in a timely manner from the authors or from the community. For any support issues - bugs, comments and suggestions - the message board is the place to go. We answer all questions within a day, and most questions within a much shorter time frame. This is the best place to have a discussion about issues and problems or simply to ask questions if you get stuck.
We also offer paid support if you feel you need more complex support or are dealing with company specific or sensitive sensitive issues.
Comment or report problem with topic