[PHP-DOC] cvs: phpdoc /de/functions pfpro.xml /en/functions pfpro.xml /fr/functions pfpro.xml /it/functions pfpro.xml From: David Croft (david <email protected>)
Date: 07/23/00

david Sun Jul 23 17:34:40 2000 EDT

  Modified files:
    /phpdoc/de/functions pfpro.xml
    /phpdoc/en/functions pfpro.xml
    /phpdoc/fr/functions pfpro.xml
    /phpdoc/it/functions pfpro.xml
  Log:
  Updates to pfpro documentation:
  
  * Now officially known as Verisign Payflow Pro.
  * Altered text that referred specifically to credit cards.
  * pfpro_init and pfpro_cleanup are no longer required functions,
    the extension will call them automatically as required, however
    they are still available to enable fine control.
  * Added warnings to be sure to read the Developers Guide.
  * Added missing semicolon on last line of example script.
  
  Note to translators: There is more to come, as the extension will soon
  have some php.ini entries.
  
  
  
Index: phpdoc/de/functions/pfpro.xml
diff -u phpdoc/de/functions/pfpro.xml:1.1 phpdoc/de/functions/pfpro.xml:1.2
--- phpdoc/de/functions/pfpro.xml:1.1 Sat Jul 15 16:38:58 2000
+++ phpdoc/de/functions/pfpro.xml Sun Jul 23 17:34:39 2000
@@ -1,10 +1,10 @@
  <reference id="ref.pfpro">
- <title>Payflow Pro functions</title>
- <titleabbrev>Payflow Pro</titleabbrev>
+ <title>Verisign Payflow Pro functions</title>
+ <titleabbrev>Verisign Payflow Pro</titleabbrev>
   <partintro>
    <simpara>
- This extension allows you to process credit cards using Verisign
- Payment Services, formerly known as Signio
+ This extension allows you to process credit cards and other financial
+ transactions using Verisign Payment Services, formerly known as Signio
     (<ulink url="&url.pfpro;">&url.pfpro;</ulink>).
    </simpara>
    <simpara>
@@ -23,14 +23,23 @@
     <filename class="directory">/usr/local/lib</filename>.
    </simpara>
    <simpara>
- When using these functions, you should call <function>pfpro_init</function>
- once before you process any transactions, and
- <function>pfpro_cleanup</function> afterwards. You may make any number
+ When using these functions, you may omit calls to
+ <function>pfpro_init</function> and <function>pfpro_cleanup</function>
+ as this extension will do so automatically if required. However the
+ functions are still available in case you are processing a number of
+ transactions and require fine control over the library.
+ You may perform any number
     of transactions using <function>pfpro_process</function> between the two.
    </simpara>
    <simpara>
     These functions have been added in PHP 4.0.2.
    </simpara>
+
+ <note><para>
+ These functions only provide a link to Verisign Payment Services. Be sure
+ to read the Payflow Pro Developers Guide for full details of the required
+ parameters.
+ </para></note>
   </partintro>
 
   <refentry id="function.pfpro-init">
@@ -48,8 +57,9 @@
     </funcsynopsis>
     <para>
      <function>pfpro_init</function> is used to initialise
- the Payflow Pro library. It must be called before processing
- any transactions.
+ the Payflow Pro library. You may omit this call, in which case
+ this extension will automatically call <function>pfpro_init</function>
+ before the first transaction.
     </para>
     <para>
      See also <function>pfpro_cleanup</function>.
@@ -73,8 +83,10 @@
     <para>
      <function>pfpro_cleanup</function> is used to shutdown the
      Payflow Pro library cleanly. It should be called after you
- have processed any transactions and before your script
- terminates.
+ have processed any transactions and before the end of your script.
+ However you may omit this call, in which case this
+ extension will automatically call <function>pfpro_cleanup</function>
+ after your script terminates.
     </para>
     <para>
      See also <function>pfpro_init</function>.
@@ -157,8 +169,8 @@
     </para>
 
     <note><para>
- You must have called <function>pfpro_init</function> before
- calling this function.
+ Be sure to read the Payflow Pro Developers Guide for full details
+ of the required parameters.
     </para></note>
 
     <example>
@@ -180,10 +192,10 @@
 $response = pfpro_process($transaction);
 
 if (!$response) {
- die("Couldn't establish link to Signio.\n");
+ die("Couldn't establish link to Verisign.\n");
 }
 
-echo "Signio response code was ".$response[RESULT];
+echo "Verisign response code was ".$response[RESULT];
 echo ", which means: ".$response[RESPMSG]."\n";
 
 echo "\nThe transaction request: ";
@@ -192,7 +204,7 @@
 echo "\nThe response: ";
 print_r($response);
 
-pfpro_cleanup()
+pfpro_cleanup();
 
 ?>
      </programlisting>
@@ -253,8 +265,9 @@
     </para>
 
     <note><para>
- You must have called <function>pfpro_init</function> before
- calling this function.
+ Be sure to read the Payflow Pro Developers Guide for full details
+ of the required parameters and encoding rules. You would be
+ well advised to use <function>pfpro_process</function> instead.
     </para></note>
 
     <example>
@@ -267,12 +280,12 @@
 $response = pfpro_process("USER=mylogin&amp;PWD[5]=m&amp;ndy&amp;TRXTYPE=S&amp;TENDER=C&amp;AMT=1.50&amp;ACCT=4111111111111111&amp;EXPDATE=0904");
 
 if (!$response) {
- die("Couldn't establish link to Signio.\n");
+ die("Couldn't establish link to Verisign.\n");
 }
 
-echo "Signio raw response was ".$response;
+echo "Verisign raw response was ".$response;
 
-pfpro_cleanup()
+pfpro_cleanup();
 
 ?>
      </programlisting>
Index: phpdoc/en/functions/pfpro.xml
diff -u phpdoc/en/functions/pfpro.xml:1.3 phpdoc/en/functions/pfpro.xml:1.4
--- phpdoc/en/functions/pfpro.xml:1.3 Fri Jul 14 19:43:08 2000
+++ phpdoc/en/functions/pfpro.xml Sun Jul 23 17:34:39 2000
@@ -1,10 +1,10 @@
  <reference id="ref.pfpro">
- <title>Payflow Pro functions</title>
- <titleabbrev>Payflow Pro</titleabbrev>
+ <title>Verisign Payflow Pro functions</title>
+ <titleabbrev>Verisign Payflow Pro</titleabbrev>
   <partintro>
    <simpara>
- This extension allows you to process credit cards using Verisign
- Payment Services, formerly known as Signio
+ This extension allows you to process credit cards and other financial
+ transactions using Verisign Payment Services, formerly known as Signio
     (<ulink url="&url.pfpro;">&url.pfpro;</ulink>).
    </simpara>
    <simpara>
@@ -23,14 +23,23 @@
     <filename class="directory">/usr/local/lib</filename>.
    </simpara>
    <simpara>
- When using these functions, you should call <function>pfpro_init</function>
- once before you process any transactions, and
- <function>pfpro_cleanup</function> afterwards. You may make any number
+ When using these functions, you may omit calls to
+ <function>pfpro_init</function> and <function>pfpro_cleanup</function>
+ as this extension will do so automatically if required. However the
+ functions are still available in case you are processing a number of
+ transactions and require fine control over the library.
+ You may perform any number
     of transactions using <function>pfpro_process</function> between the two.
    </simpara>
    <simpara>
     These functions have been added in PHP 4.0.2.
    </simpara>
+
+ <note><para>
+ These functions only provide a link to Verisign Payment Services. Be sure
+ to read the Payflow Pro Developers Guide for full details of the required
+ parameters.
+ </para></note>
   </partintro>
 
   <refentry id="function.pfpro-init">
@@ -48,8 +57,9 @@
     </funcsynopsis>
     <para>
      <function>pfpro_init</function> is used to initialise
- the Payflow Pro library. It must be called before processing
- any transactions.
+ the Payflow Pro library. You may omit this call, in which case
+ this extension will automatically call <function>pfpro_init</function>
+ before the first transaction.
     </para>
     <para>
      See also <function>pfpro_cleanup</function>.
@@ -73,8 +83,10 @@
     <para>
      <function>pfpro_cleanup</function> is used to shutdown the
      Payflow Pro library cleanly. It should be called after you
- have processed any transactions and before your script
- terminates.
+ have processed any transactions and before the end of your script.
+ However you may omit this call, in which case this
+ extension will automatically call <function>pfpro_cleanup</function>
+ after your script terminates.
     </para>
     <para>
      See also <function>pfpro_init</function>.
@@ -157,8 +169,8 @@
     </para>
 
     <note><para>
- You must have called <function>pfpro_init</function> before
- calling this function.
+ Be sure to read the Payflow Pro Developers Guide for full details
+ of the required parameters.
     </para></note>
 
     <example>
@@ -180,10 +192,10 @@
 $response = pfpro_process($transaction);
 
 if (!$response) {
- die("Couldn't establish link to Signio.\n");
+ die("Couldn't establish link to Verisign.\n");
 }
 
-echo "Signio response code was ".$response[RESULT];
+echo "Verisign response code was ".$response[RESULT];
 echo ", which means: ".$response[RESPMSG]."\n";
 
 echo "\nThe transaction request: ";
@@ -192,7 +204,7 @@
 echo "\nThe response: ";
 print_r($response);
 
-pfpro_cleanup()
+pfpro_cleanup();
 
 ?>
      </programlisting>
@@ -253,8 +265,9 @@
     </para>
 
     <note><para>
- You must have called <function>pfpro_init</function> before
- calling this function.
+ Be sure to read the Payflow Pro Developers Guide for full details
+ of the required parameters and encoding rules. You would be
+ well advised to use <function>pfpro_process</function> instead.
     </para></note>
 
     <example>
@@ -267,12 +280,12 @@
 $response = pfpro_process("USER=mylogin&amp;PWD[5]=m&amp;ndy&amp;TRXTYPE=S&amp;TENDER=C&amp;AMT=1.50&amp;ACCT=4111111111111111&amp;EXPDATE=0904");
 
 if (!$response) {
- die("Couldn't establish link to Signio.\n");
+ die("Couldn't establish link to Verisign.\n");
 }
 
-echo "Signio raw response was ".$response;
+echo "Verisign raw response was ".$response;
 
-pfpro_cleanup()
+pfpro_cleanup();
 
 ?>
      </programlisting>
Index: phpdoc/fr/functions/pfpro.xml
diff -u phpdoc/fr/functions/pfpro.xml:1.1 phpdoc/fr/functions/pfpro.xml:1.2
--- phpdoc/fr/functions/pfpro.xml:1.1 Sat Jul 22 03:17:10 2000
+++ phpdoc/fr/functions/pfpro.xml Sun Jul 23 17:34:39 2000
@@ -1,10 +1,10 @@
  <reference id="ref.pfpro">
- <title>Payflow Pro functions</title>
- <titleabbrev>Payflow Pro</titleabbrev>
+ <title>Verisign Payflow Pro functions</title>
+ <titleabbrev>Verisign Payflow Pro</titleabbrev>
   <partintro>
    <simpara>
- This extension allows you to process credit cards using Verisign
- Payment Services, formerly known as Signio
+ This extension allows you to process credit cards and other financial
+ transactions using Verisign Payment Services, formerly known as Signio
     (<ulink url="&url.pfpro;">&url.pfpro;</ulink>).
    </simpara>
    <simpara>
@@ -23,14 +23,23 @@
     <filename class="directory">/usr/local/lib</filename>.
    </simpara>
    <simpara>
- When using these functions, you should call <function>pfpro_init</function>
- once before you process any transactions, and
- <function>pfpro_cleanup</function> afterwards. You may make any number
+ When using these functions, you may omit calls to
+ <function>pfpro_init</function> and <function>pfpro_cleanup</function>
+ as this extension will do so automatically if required. However the
+ functions are still available in case you are processing a number of
+ transactions and require fine control over the library.
+ You may perform any number
     of transactions using <function>pfpro_process</function> between the two.
    </simpara>
    <simpara>
     These functions have been added in PHP 4.0.2.
    </simpara>
+
+ <note><para>
+ These functions only provide a link to Verisign Payment Services. Be sure
+ to read the Payflow Pro Developers Guide for full details of the required
+ parameters.
+ </para></note>
   </partintro>
 
   <refentry id="function.pfpro-init">
@@ -48,8 +57,9 @@
     </funcsynopsis>
     <para>
      <function>pfpro_init</function> is used to initialise
- the Payflow Pro library. It must be called before processing
- any transactions.
+ the Payflow Pro library. You may omit this call, in which case
+ this extension will automatically call <function>pfpro_init</function>
+ before the first transaction.
     </para>
     <para>
      See also <function>pfpro_cleanup</function>.
@@ -73,8 +83,10 @@
     <para>
      <function>pfpro_cleanup</function> is used to shutdown the
      Payflow Pro library cleanly. It should be called after you
- have processed any transactions and before your script
- terminates.
+ have processed any transactions and before the end of your script.
+ However you may omit this call, in which case this
+ extension will automatically call <function>pfpro_cleanup</function>
+ after your script terminates.
     </para>
     <para>
      See also <function>pfpro_init</function>.
@@ -157,8 +169,8 @@
     </para>
 
     <note><para>
- You must have called <function>pfpro_init</function> before
- calling this function.
+ Be sure to read the Payflow Pro Developers Guide for full details
+ of the required parameters.
     </para></note>
 
     <example>
@@ -180,10 +192,10 @@
 $response = pfpro_process($transaction);
 
 if (!$response) {
- die("Couldn't establish link to Signio.\n");
+ die("Couldn't establish link to Verisign.\n");
 }
 
-echo "Signio response code was ".$response[RESULT];
+echo "Verisign response code was ".$response[RESULT];
 echo ", which means: ".$response[RESPMSG]."\n";
 
 echo "\nThe transaction request: ";
@@ -192,7 +204,7 @@
 echo "\nThe response: ";
 print_r($response);
 
-pfpro_cleanup()
+pfpro_cleanup();
 
 ?>
      </programlisting>
@@ -253,8 +265,9 @@
     </para>
 
     <note><para>
- You must have called <function>pfpro_init</function> before
- calling this function.
+ Be sure to read the Payflow Pro Developers Guide for full details
+ of the required parameters and encoding rules. You would be
+ well advised to use <function>pfpro_process</function> instead.
     </para></note>
 
     <example>
@@ -267,12 +280,12 @@
 $response = pfpro_process("USER=mylogin&amp;PWD[5]=m&amp;ndy&amp;TRXTYPE=S&amp;TENDER=C&amp;AMT=1.50&amp;ACCT=4111111111111111&amp;EXPDATE=0904");
 
 if (!$response) {
- die("Couldn't establish link to Signio.\n");
+ die("Couldn't establish link to Verisign.\n");
 }
 
-echo "Signio raw response was ".$response;
+echo "Verisign raw response was ".$response;
 
-pfpro_cleanup()
+pfpro_cleanup();
 
 ?>
      </programlisting>
Index: phpdoc/it/functions/pfpro.xml
diff -u phpdoc/it/functions/pfpro.xml:1.1 phpdoc/it/functions/pfpro.xml:1.2
--- phpdoc/it/functions/pfpro.xml:1.1 Sat Jul 15 16:38:58 2000
+++ phpdoc/it/functions/pfpro.xml Sun Jul 23 17:34:40 2000
@@ -1,10 +1,10 @@
  <reference id="ref.pfpro">
- <title>Payflow Pro functions</title>
- <titleabbrev>Payflow Pro</titleabbrev>
+ <title>Verisign Payflow Pro functions</title>
+ <titleabbrev>Verisign Payflow Pro</titleabbrev>
   <partintro>
    <simpara>
- This extension allows you to process credit cards using Verisign
- Payment Services, formerly known as Signio
+ This extension allows you to process credit cards and other financial
+ transactions using Verisign Payment Services, formerly known as Signio
     (<ulink url="&url.pfpro;">&url.pfpro;</ulink>).
    </simpara>
    <simpara>
@@ -23,14 +23,23 @@
     <filename class="directory">/usr/local/lib</filename>.
    </simpara>
    <simpara>
- When using these functions, you should call <function>pfpro_init</function>
- once before you process any transactions, and
- <function>pfpro_cleanup</function> afterwards. You may make any number
+ When using these functions, you may omit calls to
+ <function>pfpro_init</function> and <function>pfpro_cleanup</function>
+ as this extension will do so automatically if required. However the
+ functions are still available in case you are processing a number of
+ transactions and require fine control over the library.
+ You may perform any number
     of transactions using <function>pfpro_process</function> between the two.
    </simpara>
    <simpara>
     These functions have been added in PHP 4.0.2.
    </simpara>
+
+ <note><para>
+ These functions only provide a link to Verisign Payment Services. Be sure
+ to read the Payflow Pro Developers Guide for full details of the required
+ parameters.
+ </para></note>
   </partintro>
 
   <refentry id="function.pfpro-init">
@@ -48,8 +57,9 @@
     </funcsynopsis>
     <para>
      <function>pfpro_init</function> is used to initialise
- the Payflow Pro library. It must be called before processing
- any transactions.
+ the Payflow Pro library. You may omit this call, in which case
+ this extension will automatically call <function>pfpro_init</function>
+ before the first transaction.
     </para>
     <para>
      See also <function>pfpro_cleanup</function>.
@@ -73,8 +83,10 @@
     <para>
      <function>pfpro_cleanup</function> is used to shutdown the
      Payflow Pro library cleanly. It should be called after you
- have processed any transactions and before your script
- terminates.
+ have processed any transactions and before the end of your script.
+ However you may omit this call, in which case this
+ extension will automatically call <function>pfpro_cleanup</function>
+ after your script terminates.
     </para>
     <para>
      See also <function>pfpro_init</function>.
@@ -157,8 +169,8 @@
     </para>
 
     <note><para>
- You must have called <function>pfpro_init</function> before
- calling this function.
+ Be sure to read the Payflow Pro Developers Guide for full details
+ of the required parameters.
     </para></note>
 
     <example>
@@ -180,10 +192,10 @@
 $response = pfpro_process($transaction);
 
 if (!$response) {
- die("Couldn't establish link to Signio.\n");
+ die("Couldn't establish link to Verisign.\n");
 }
 
-echo "Signio response code was ".$response[RESULT];
+echo "Verisign response code was ".$response[RESULT];
 echo ", which means: ".$response[RESPMSG]."\n";
 
 echo "\nThe transaction request: ";
@@ -192,7 +204,7 @@
 echo "\nThe response: ";
 print_r($response);
 
-pfpro_cleanup()
+pfpro_cleanup();
 
 ?>
      </programlisting>
@@ -253,8 +265,9 @@
     </para>
 
     <note><para>
- You must have called <function>pfpro_init</function> before
- calling this function.
+ Be sure to read the Payflow Pro Developers Guide for full details
+ of the required parameters and encoding rules. You would be
+ well advised to use <function>pfpro_process</function> instead.
     </para></note>
 
     <example>
@@ -267,12 +280,12 @@
 $response = pfpro_process("USER=mylogin&amp;PWD[5]=m&amp;ndy&amp;TRXTYPE=S&amp;TENDER=C&amp;AMT=1.50&amp;ACCT=4111111111111111&amp;EXPDATE=0904");
 
 if (!$response) {
- die("Couldn't establish link to Signio.\n");
+ die("Couldn't establish link to Verisign.\n");
 }
 
-echo "Signio raw response was ".$response;
+echo "Verisign raw response was ".$response;
 
-pfpro_cleanup()
+pfpro_cleanup();
 
 ?>
      </programlisting>