home *** CD-ROM | disk | FTP | other *** search
/ Enter 2004 June / ENTER.ISO / files / xampp-win32-1.4.5-installer.exe / xampp / HTML_Progress.pkg < prev    next >
Encoding:
Text File  |  2004-03-24  |  4.5 KB  |  97 lines
  1. <refentry id="{@id}">
  2.  <refnamediv>
  3.   <refname>HTML_Progress 1.x Guide</refname>
  4.   <refpurpose>introduction to HTML_Progress package</refpurpose>
  5.  </refnamediv>
  6.  <refsynopsisdiv>
  7.   <refsynopsisdivinfo>
  8.    <author>
  9.     by Laurent Laville
  10.     <authorblurb>{@link mailto:pear@laurent-laville.org}</authorblurb>
  11.    </author>
  12.    <copyright>November 2003, Laurent Laville</copyright>
  13.    <releaseinfo>HTML_Progress 1.0+</releaseinfo>
  14.   </refsynopsisdivinfo>
  15.  </refsynopsisdiv>
  16.  {@toc}
  17.  <refsect1 id="{@id whatisit}">
  18.   <title>What is HTML_Progress ?</title>
  19.   <para>
  20.    HTML_Progress is a OO class {@link http://pear.php.net PEAR} package for 
  21.    {@link http://www.php.net PHP} 4.1 or better.
  22.   </para>
  23.   <para>
  24.    HTML_Progress makes it easy to build and display an horizontal or vertical loading bar 
  25.    on XHTML document of your choice, 
  26.    and allows user to wait and see progress status during a long procedure such an installation.
  27.    You get a more or less decent result with just the basic settings, but it's also 
  28.    highly configurable, so you can almost get what you want.
  29.   </para>
  30.   <para>
  31.    The core class assigns context sensitive default values for most of the parameters 
  32.    which minimizes the learning part. The features are there when you need it - 
  33.    they don't get in your way. The package also comes with very extensive documentation.
  34.   </para>
  35.  </refsect1>
  36.  <refsect1 id="{@id features}">
  37.   <title>Features</title>
  38.    <unorderedlist>
  39.     <listitem><para>Create horizontal and also vertival bar</para></listitem>
  40.     <listitem><para>Allows usage of an existing external StyleSheet 
  41.      and/or JavaScript </para></listitem>
  42.     <listitem><para>All elements (progress, cells, string) are customizable 
  43.      by their html properties</para></listitem>
  44.     <listitem><para>percent/string is floating all around the progress bar</para></listitem>
  45.     <listitem><para>Compliant with all CSS/XHMTL standards</para></listitem>
  46.     <listitem><para>Integration with all template engines is very easy</para></listitem>
  47.     <listitem><para>Implements a Observer design pattern. 
  48.      It is possible to add Listeners.</para></listitem>
  49.     <listitem><para>Adds a customizable UI monitor pattern to display a progress bar.
  50.      User-end can abort progress at any time.</para></listitem>
  51.     <listitem><para>Look and feel can be sets by internal API or external config file.
  52.      </para></listitem>
  53.     <listitem><para>Allows many progress bar on same page without uses of 
  54.      iframe solution.</para></listitem>
  55.    </unorderedlist>
  56.  </refsect1>
  57.  <refsect1 id="{@id license}">
  58.   <title>Software license</title>
  59.    <para>HTML_Progress is released under 
  60.     {@link http://www.php.net/license/3_0.txt PHP License 3.0}</para>
  61.  </refsect1>
  62.  <refsect1 id="{@id gallery}">
  63.   <title>Image gallery</title>
  64.    <para>Below is a few sample images all created with HTML_Progress.</para>
  65.    <para><graphic fileref="../media/screenshots/ancestor.png"></graphic></para>
  66.    <para><graphic fileref="../media/screenshots/bullit.png"></graphic></para>
  67.    <para><graphic fileref="../media/screenshots/redsandback.png"></graphic></para>
  68.    <para><graphic fileref="../media/screenshots/vertical1.png"></graphic></para>
  69.  </refsect1>
  70.  <refsect1 id="{@id faq}">
  71.   <title>FAQ</title>
  72.    <unorderedlist>
  73.     <listitem><para><important>May i use my favorite template engine ?</important></para>
  74.      <para>Yes, integrate HTML_Progress is also easy that put any other HTML element. 
  75.       See <emphasis>template_embedded.php</emphasis> in examples subdirectory of 
  76.       bundle distribution, for an IT[x] template family example.
  77.      </para>
  78.     </listitem>
  79.     <listitem><para><important>I got only 0% displayed on left corner of my browser screen</important></para>
  80.      <para>You've forgot to send the necessary styles (CSS).
  81.       See {@tutorial beginner.pkg#basics.starting} for details and solution.
  82.      </para>
  83.     </listitem>
  84.     <listitem><para><important>The progress bar is running, but i see no changes</important></para>
  85.      <para>You've forgot to put the requires JavaScript code to manage the progress bar.
  86.       See {@tutorial beginner.pkg#basics.using} for details and solution.
  87.      </para>
  88.     </listitem>
  89.     <listitem><para><important>The progress bar is running, but percent info is frozen to 0%</important></para>
  90.      <para>You've a browser that is not fully DHTML compliant. For example Opera 6.x. 
  91.       You should upgrade to the most recent browser version.
  92.      </para>
  93.     </listitem>
  94.    </unorderedlist>
  95.  </refsect1>
  96. </refentry>
  97.