PHP Classes
elePHPant
Icontem

FiForms Framework: Framework for rapid Web application development

Recommend this page to a friend!
Stumble It! Stumble It! Bookmark in del.icio.us Bookmark in del.icio.us
  Info   View files View files (44)   DownloadInstall with Composer Download .zip   Reputation   Support forum (1)   Blog    
Last Updated Ratings Unique User Downloads Download Rankings  
2005-04-25 (10 years ago) RSS 2.0 feedNot enough user ratingsTotal: 2,690 This week: 1All time: 1,325 This week: 1,104Up
Version License PHP version Categories  
fiforms 0.9.3GNU General Publi...5.0HTML, Databases, Libraries
Description Author  

The FiForms Framework is an application development framework for building Web-database applications in XML, powered by MySQL and PHP. AJAX-enhanced forms, sub-forms, custom reports, and dynamically generated menus create a seamless user experience. The FiForms Framework lets you rapidly prototype and develop a Web/database front end using the latest PHP and XML technologies. It currently includes data-entry classes and XML report generation scripts. The libraries utilize the new XML capabilities of PHP 5 to create a framework for developing Web applications completely in XML languages.

Picture of Daniel McFeeters
Name: Daniel McFeeters <contact>
Classes: 1 package by
Country: United States United States
Age: 30
All time rank: 1085144 in United States United States
Week rank: 883 Up104 in United States United States Up

Details provided by the author  
FiForms Framework 1.1
===============================

This is the README for the FiForms Framework version 1.1. 
The FiForms Framework enables developers to build web/database 
applications rapidly in XML. Using the unique FiForms XML 
Application Markup, a developer can build a complete database 
application without writing a single line of PHP code. 
      
History

FiForms started as a collection of PHP classes for creating web-based data 
entry screens for a MySQL database. It has since grown into a collection 
of projects addressing many aspects of web-database development needs. 
The FiForms framework currently includes the FiForms data-entry classes 
and the FiReports XML report generation scripts. These libraries are 
combined scripts which utilize the new XML capabilities of PHP version 5 
to create a framework for developing web applications completely in XML. 

The latest version of this software is available at the following web site:

  <http://www.fiforms.org>

You can find documentation and setup instructions for the FiForms Framework
on the wiki:

  <http://wiki.fiforms.org/>

Documentation for XML schemas can be found at

  <http://xml.fiforms.org/>
  
Quick Installation
==================

To get FiForms up-and-running quickly, we suggest you follow the instructions
outline on the wiki page http://wiki.fiforms.org/index.php/Installation

Requirements
============

Before you can use FiForms, you must have the following software installed on 
your system:

*   an operating system (of course)
        FiForms should work on any operating system that Apache and PHP
	will run on. Most of the development and testing of FiForms has
	been done on Linux, but it should also run under Windows, OS X,
	BSD, etc. 

*   an http webserver (works best on Apache webserver)
            <http://apache.org> 

*   MySQL database server <http://mysql.org> 
	FiForms works well with MySQL 4.0, 4.1, and 5.0. It should also 
	work with other versions.

*   a PHP interpreter <http://www.php.net> FiForms requires PHP 5.x. 

*   Php.XPath (this is included with FiForms if you are installing using
        a pre-built package or installer)
        <http://sourceforge.net/projects/phpxpath/> 

*   XSLTProc (required if you will be using FiReportsXML with server-side
	      transformation, and you are not using PHP_XSLT)
	<http://xmlsoft.org/XSLT/>
	Install libxslt on your operating system and configure the path
	to XSLTProc in FiForms_global.inc.php

	Note to windows users:  
        A package containing all the programs you need is available at
        http://downloads.sourceforge.net/myforms/FiForms_Binary_Dependencies_Win.zip

        This is a compliation of binaries available on Igor Zlatkovic' website:
	http://www.zlatkovic.com/libxml.en.html You can, alternativly, download
	libxml2, libxslt, iconv, and zlib from his website yourself. Extract 
	each zip file and copy the contents of each bin directory into 
	a single directory. Then point FIFORMS_XSLTPROC to the path you set.
	For example, if you copied the files to c:/libxml2, put this line 
	in FiForms_global.inc.php:

	define("FIFORMS_XSLTPROC","c:/libxml2/xsltproc.exe");
	

*   A Web Browser (On each client machine)
      Recommended: Mozilla Firefox Web Browser
             <http://mozilla.org/>

	Note: FiForms Forms should work fine in any browser
	     (Firefox, Lynx, IE, etc). Depending on the way you configure
	     the FiReport generator, you may require a browser that
	     supports XML and XSLT (Firefox and IE 6 both do). This is the
	     case if FiReports is configured for client-side transformation.
	     If it is configured for server-side transformation, you will
	     have to have xsltproc installed on the server but any browser
	     will work on the client (including Konqueror, Lynx, and older
	     version of IE which don't support XML). 

*    Jaxe or your favorite XML editor (http://jaxe.sourceforge.net/)
	This software can save you a lot of time in creating FiForms XML 
	applications. Jaxe configuration files for the FiForms XML schema
	are included in the package under example/jaxe. Simply copy these
	into your jaxe/config directory to start using them. 

Installation
============


Unzip the contents of the archive file into a new directory (if
you have not already done so). We recommend placing FiForms
outside of the DocumentRoot of your webserver, and configuring
an alias to the scripts/ directory of FiForms in your
webserver configuration.

Once FiForms is installed, direct your browser to the scripts path
in the new installation, for example, http://localhost/scripts/
or http://localhost/FiForms/scripts/ . You should be greeted
with a configuration screen, where you can set parameters. 

Follow the on-screen instructions to complete the installation.

Now you should be ready to start creating FiForms XML applications. 

Take a look at the examples included with this distribution. This
will show you how you can make some simple FiForms. Before you can use the 
sample scripts, you will need to set up the MySQL database FiForms_sample. Use
the included FiForms-sample.sql script to set up the database with the 
necessary tables. Of course, there are a lot more features in FiForms than are 
documented in the sample applications; please refer to the wiki and XML
documentation online.


5-Minute Tutorial
=================

FiForms XML Application
-----------------------

Create a new directory structure under the apps directory in FiForms. The top 
level directory should be the name of your app. This directory should contain
three subdirectories named forms, menus, and reports. All directory names are
case-sensitive.  "Register" the application by creating the appinfo.xml
file in the application root. Create a Main Menu called main.xml in the menus 
directory. Place form and report definitions in their respective folders. 
References from the menu are relative to the base of their respective folders; 
i.e. you do not need to specify path in the href when linking to forms and 
reports from your menu. See the example application for more ideas.

FiForms PHP Application
-----------------------

Create your PHP scripts anywhere you want, but make sure the scripts are able
to find the include files. This can be done using .htaccess files similar to
the one in the example directory, or by adding the FiForms_includes directory
to your include_path in php.ini. 

For both XML Applications and PHP Applications, please make use of the example
files included with this distribution. 

Note: this method of creating applications is no longer recommended; please
consider creating your new applications in XML.

Authors
=======

Founding Author: 
    Daniel McFeeters <databases at alltel dot net>

Contributing Authors: 
    Kristina Reeve <covrainbow at yahoo dot com>
    D. Kevin Burk <dkburk at gmail dot com>
    Jared Colangelo <pilotpencil at users dot sourceforge dot net>

Credits
    Kristina Reeve
        Development assistance, consultation, and inspiration to 
        keep this project going.
    The Somerset Oil Refinery <http://somersetoil.com>
        Supporting development, testing software
    Jim McFeeters <http://scc-it.serveftp.net>
        Teaching me programming, and helping with suggestions
	in several features of FiForms
    D. Kevin Burk
        For (indirectly) challenging me to write this
	in the first place. 


Contributing
============

If you would like to contribute to this project, or if you have any questions 
or suggestions, send an e-mail to Daniel McFeeters <databases at alltel dot net>


Bugs and To-Do List
===================

See the Wiki http://wiki.fiforms.org/


License
=======

    Copyright (C) 2003-2008  Daniel McFeeters

    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU General Public
    License as published by the Free Software Foundation; either
    version 2 of the License, or (at your option) any later version.

    This library is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
    General Public License for more details.

    You should have received a copy of the GNU General Public
    License along with this library; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  Files folder image Files  
File Role Description
Files folder imageexample (4 files)
Files folder imageFiForms-includes (24 files)
Files folder imagescripts (2 files, 1 directory)
Accessible without login HTML file index.html Data Documentation Home Page
Plain text file LICENSE.txt Lic. GNU LGPL License
Accessible without login Plain text file README.txt Doc. Readme and installation instructions

  Files folder image Files  /  example  
File Role Description
  Plain text file FiForms-sample.sql Data Script to build a sample database for use with the example scripts
  Accessible without login Plain text file sample.php Example Extended example script
  Accessible without login Plain text file sample_subform.php Example Example subform
  Accessible without login Plain text file simple.php Example Short example script

  Files folder image Files  /  FiForms-includes  
File Role Description
  Plain text file FiForms_BasicAuth.inc.php Class Authentication Module using HTTP Basic Authentication
  Plain text file FiForms_FiForm.inc.php Class Main FiForms include script
  Plain text file FiForms_fillVars.inc.php Aux. Supporting script
  Plain text file FiForms_genericHTML.inc.php Class Supporting script
  Plain text file FiForms_genericIcons.inc.php Class Supporting script
  Plain text file FiForms_global.inc.php Conf. Global FiForms Configuration File. Edit this for site-specific settings.
  Plain text file FiForms_iCheck.inc.php Class Supporting script
  Plain text file FiForms_iContainer.inc.php Class Supporting script
  Plain text file FiForms_iCustomInput.inc.php Class Supporting script
  Plain text file FiForms_iDateText.inc.php Class Supporting script
  Plain text file FiForms_iDBSelect.inc.php Class Supporting script
  Plain text file FiForms_iFile.inc.php Class Supporting script
  Plain text file FiForms_iFormControl.inc.php Class Supporting script
  Plain text file FiForms_iHidden.inc.php Class Supporting script
  Plain text file FiForms_iInput.inc.php Class Base class for almost all other FiForms Classes
  Plain text file FiForms_iLink.inc.php Class Supporting script
  Plain text file FiForms_iLinkBack.inc.php Class Supporting script
  Plain text file FiForms_imports.inc.php Aux. Supporting script
  Plain text file FiForms_iROText.inc.php Class Supporting script
  Plain text file FiForms_iSubform.inc.php Class Supporting script
  Plain text file FiForms_iSubmit.inc.php Class Supporting script
  Plain text file FiForms_iText.inc.php Class Supporting script
  Plain text file FiForms_iTextArea.inc.php Class Base class for almost all other FiForms Classes
  Plain text file FiForms_selectValue.inc.php Aux. PHP function to get a single variable from MySQL

  Files folder image Files  /  scripts  
File Role Description
Files folder imagethemes (1 directory)
  Plain text file CalendarPopup.js Aux. CalendarPopup Javascript Functions
  Plain text file fiform.js Data External JavaScript functions

  Files folder image Files  /  scripts  /  themes  
File Role Description
Files folder imagecleanblue-png (3 files, 1 directory)

  Files folder image Files  /  scripts  /  themes  /  cleanblue-png  
File Role Description
Files folder imagepng-small (8 files)
  Plain text file CalendarPopup.css Data CalendarPopup Stylesheet
  Plain text file fiform_style.css Data CSS Stylesheet
  Plain text file iconset.php Class Icon Theme Script

  Files folder image Files  /  scripts  /  themes  /  cleanblue-png  /  png-small  
File Role Description
  Image file back.png Icon Back Button
  Image file delete.png Icon Delete Button
  Image file down.png Icon Down icon
  Image file first.png Icon First Button
  Image file forward.png Icon Forward Button
  Image file last.png Icon Last Button
  Image file new.png Icon New Button
  Image file sheet.png Icon Sheet Button

 Version Control Unique User Downloads Download Rankings  
 0%Total:2,690All time:1,325
 This week:1This week:1,104Up