mk Tue Mar 12 12:14:41 2002 EDT
Added files:
/phpdoc/de/functions cybermut.xml
Log:
Translated the docs for my favourite extension ;)
Index: phpdoc/de/functions/cybermut.xml
+++ phpdoc/de/functions/cybermut.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.16 Maintainer: mk Status: ready -->
<reference id="ref.cybermut">
<title>Crédit Mutuel CyberMUT functions</title>
<titleabbrev>CyberMUT</titleabbrev>
<partintro>
<simpara>
Diese Extension ist f�r den Ablauf der Kreditkartentransaktionen des
Crédit Mutuel CyberMUT Systems (
<ulink url="&url.cybermut;">&url.cybermut;</ulink>) zust�ndig.
</simpara>
<simpara>
CyberMUT ist ein popul�rer franz�sischer Service der Bank Crédit Mutuel f�r
das Bezahlen im Web.
Wenn Sie nicht aus Frankreich sind werden Sie mit diesen Funktionen nichts
anfangen k�nnen.
</simpara>
<simpara>
Diese Funktionen sind nur verf�gbar, wenn PHP mit der Option
<link linkend="install.configure.with-cybermut"><option role="configure">
--with-cybermut[=DIR]</option></link>
kompiliert wurde, wobei der Parameter DIR auf das Verzeichnis zeigt, in dem sich
die Dateien
<filename>libcm-mac.a</filename> und <filename>cm-mac.h</filename> befinden.
Sie ben�tigen das entsprechende SDK f�r Ihr Betriebssytem, welches Ihnen nach der
Bestellung von
CyberMUT zugesendet wird (Kontakt: �ber das Web oder in der n�chsten Filiale der
Crédit Mutuel).
</simpara>
<simpara>
Die Verwendung dieser Funktionen ist weitgehend identisch mit den original
Funktionen, bis auf die
R�ckgabewerte der Funktionen <function>cybermut_creerformulairecm</function>
und <function>cybermut_creerreponsecm</function>,
welche vond en PHP-Funktionen direkt zur�ckgegeben werden und in den
Originalfunktionen nur referenziert werden.
</simpara>
<simpara>
Diese Funktionen wurden in PHP 4.0.6 hinzugef�gt.
</simpara>
<note>
<para>
Diese Funktionen stellen nur eine Verbindung zum CyberMUT SDK her. Lesen Sie auf
jeden Fall den
CyberMUT Developers Guide f�r alle Details der ben�tigten Parameter.
</para>
</note>
</partintro>
<refentry id="function.cybermut-creerformulairecm">
<refnamediv>
<refname>cybermut_creerformulairecm</refname>
<refpurpose>Generiert ein HTML Formular f�r eine Zahlungaufforderung</refpurpose>
</refnamediv>
<refsect1>
<title>Beschreibung</title>
<methodsynopsis>
<type>string</type><methodname>cybermut_creerformulairecm</methodname>
<methodparam><type>string</type><parameter>url_CM</parameter></methodparam>
<methodparam><type>string</type><parameter>version</parameter></methodparam>
<methodparam><type>string</type><parameter>TPE</parameter></methodparam>
<methodparam><type>string</type><parameter>montant</parameter></methodparam>
<methodparam><type>string</type><parameter>ref_commande</parameter></methodparam>
<methodparam><type>string</type><parameter>texte_libre</parameter></methodparam>
<methodparam><type>string</type><parameter>url_retour</parameter></methodparam>
<methodparam><type>string</type><parameter>url_retour_ok</parameter></methodparam>
<methodparam><type>string</type><parameter>url_retour_err</parameter></methodparam>
<methodparam><type>string</type><parameter>langue</parameter></methodparam>
<methodparam><type>string</type><parameter>code_societe</parameter></methodparam>
<methodparam><type>string</type><parameter>texte_bouton</parameter></methodparam>
</methodsynopsis>
<para>
<function>cybermut_creerformulairecm</function> wird dazu verwendet um ein HTML
Formular zur Zahlungsaufforderung
zu erzeugen.
</para>
<example>
<title>Erster Schritt der Bezahlung (entspricht cgi1.c)</title>
<programlisting role="php">
<![CDATA[
<?php
// Verzeichnis der Schl�ssel
putenv("CMKEYDIR=/var/creditmut/cles");
// Versionsnummer
$VERSION="1.2";
$retour = cybermut_creerformulairecm(
"https://www.creditmutuel.fr/test/telepaiement/paiement.cgi",
$VERSION,
"1234567890",
"300FRF",
$REFERENCE,
$TEXTE_LIBRE,
$URL_RETOUR,
$URL_RETOUR_OK,
$URL_RETOUR_ERR,
"francais",
"company",
"Paiement par carte bancaire");
echo $retour;
?>
]]>
</programlisting>
</example>
<para>
Siehe auch
<function>cybermut_testmac</function> und
<function>cybermut_creerreponsecm</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.cybermut-testmac">
<refnamediv>
<refname>cybermut_testmac</refname>
<refpurpose>
Stellt sicher, da� keine betr�gerischen Daten in der Best�tigungsnachricht sind.
</refpurpose>
</refnamediv>
<refsect1>
<title>Beschreibung</title>
<methodsynopsis>
<type>bool</type><methodname>cybermut_testmac</methodname>
<methodparam><type>string</type><parameter>code_MAC</parameter></methodparam>
<methodparam><type>string</type><parameter>version</parameter></methodparam>
<methodparam><type>string</type><parameter>TPE</parameter></methodparam>
<methodparam><type>string</type><parameter>cdate</parameter></methodparam>
<methodparam><type>string</type><parameter>montant</parameter></methodparam>
<methodparam><type>string</type><parameter>ref_commande</parameter></methodparam>
<methodparam><type>string</type><parameter>texte_libre</parameter></methodparam>
<methodparam><type>string</type><parameter>code-retour</parameter></methodparam>
</methodsynopsis>
<para>
<function>cybermut_testmac</function> wird dazu verwendet, sicherzustellen, da�
keine betr�gerischen oder falschen
Daten in der erhaltenen Best�tigungsnachricht sind.
Achten Sie auf die Parameter <parameter>code-retour</parameter> und
<parameter>texte-libre</parameter>, welche wegen dem Bindestrich nicht einfach
ausgewertet werden k�nnen.
Sie m�ssen sie wie folgt verwenden:
<programlisting role="php">
<![CDATA[
<?php
$code_retour=$HTTP_GET_VARS["code-retour"];
$texte_libre=$HTTP_GET_VARS["texte-libre"];
?>
]]>
</programlisting>
</para>
<example>
<title>Letzter Schritt der Bezahlung (entspricht cgi2.c)</title>
<programlisting role="php">
<![CDATA[
<?php
// Stellen Sie sicher, da� Enable Track Vars auf ON steht.
// Verzeichnis der Schl�ssel
putenv("CMKEYDIR=/var/creditmut/cles");
// Versionsnummer
$VERSION="1.2";
$texte_libre = $HTTP_GET_VARS["texte-libre"];
$code_retour = $HTTP_GET_VARS["code-retour"];
$mac_ok =
cybermut_testmac($MAC,$VERSION,$TPE,$date,$montant,$reference,$texte_libre,$code_retour);
if ($mac_ok) {
//
// insert data processing here
//
//
$result=cybermut_creerreponsecm("OK");
} else {
$result=cybermut_creerreponsecm("Document Falsifie");
}
?>
]]>
</programlisting>
</example>
<para>
Siehe auch
<function>cybermut_creerformulairecm</function> und
<function>cybermut_creerreponsecm</function>.
</para>
</refsect1>
</refentry>
<refentry id="function.cybermut-creerreponsecm">
<refnamediv>
<refname>cybermut_creerreponsecm</refname>
<refpurpose>
Generiert eine Best�tigung, da� die Zahlungsbest�tigung gesendet wurde.
</refpurpose>
</refnamediv>
<refsect1>
<title>Beschreibung</title>
<methodsynopsis>
<type>string</type><methodname>cybermut_creerreponsecm</methodname>
<methodparam><type>string</type><parameter>phrase</parameter></methodparam>
</methodsynopsis>
<para>
<function>cybermut_creerreponsecm</function> gibt einen String zur�ck, der die
Best�tigungsmeldung enth�lt.
</para>
<para>
Der Parameter ist "OK", wenn die Best�tigungsmeldung korrekt von
<function>cybermut_testmac</function> identifiziert werden konnte.
Alles andere wird als Fehlermeldung angesehen.
</para>
<para>
Siehe auch
<function>cybermut_creerformulairecm</function> und
<function>cybermut_testmac</function>.
</para>
</refsect1>
</refentry>
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->