From 62a03181333c335b6b948fbc8f3a2efa09c0a7e0 Mon Sep 17 00:00:00 2001
From: Thomas Cort <tux-translate@tux.name>
Date: Tue, 20 Nov 2007 06:19:05 -0500
Subject: [PATCH] Add skeleton code for an AddTranslation method.

The AddTranslation SOAP method will allow authorized
users to add translations. This is useful in a hosted
environment where uploading a large SQL database may
be difficult.
---
 docs/xml-instance-documents.txt | 29 ++++++++++++++++++++++++++--
 tools/tt-client.php             | 27 ++++++++++++++++++++------
 www/soap.php                    |  5 +++++
 www/soap.wsdl                   | 42 +++++++++++++++++++++++++++++++++++++++++
 4 files changed, 95 insertions(+), 8 deletions(-)

diff --git a/docs/xml-instance-documents.txt b/docs/xml-instance-documents.txt
index af5fb9a..19182df 100644
--- a/docs/xml-instance-documents.txt
+++ b/docs/xml-instance-documents.txt
@@ -11,8 +11,8 @@
 		<homepage>http://www.gnu.org/software/hello/</homepage>
 		<download>http://localhost/distfiles/hello-2.3.tar.gz</download>
 		<license>
-			<license-name>GNU General Public License v3 or Later</name>
-			<license-url>http://localhost/license/GPLv3orLater</url>
+			<license-name>GNU General Public License v3 or Later</license-name>
+			<license-url>http://localhost/license/GPLv3orLater</license-url>
 		</license>
 	</package>
 	<message>Bonjour, le monde.</message>
@@ -32,3 +32,28 @@
 	<message>This program is running as process number %(pid)d.</message>
 	<message>This program is running as process number $pid.</message>
 </SuggestResponse>
+
+<AddTranslation xmlns="http://www.tux.name/tt">
+	<auth>
+		<username>user</username>
+		<password>pass</password>
+	</auth>
+	<package>
+		<name>hello</name>
+		<version>2.3</version>
+		<homepage>http://www.gnu.org/software/hello/</homepage>
+		<download>http://localhost/distfiles/hello-2.3.tar.gz</download>
+		<license>
+			<license-name>GNU General Public License v3 or Later</license-name>
+			<license-url>http://localhost/license/GPLv3orLater</license-url>
+		</license>
+	</package>
+	<source-language>en</source-language>
+	<source-message>hello, world</source-message>
+	<target-language>fr</target-language>
+	<target-message>Bonjour, le monde.</target-message>
+</AddTranslation>
+
+<AddTranslationResponse xmlns="http://www.tux.name/tt">
+	<success>true</success>
+</AddTranslation>
diff --git a/tools/tt-client.php b/tools/tt-client.php
index bd33081..3ab01d9 100644
--- a/tools/tt-client.php
+++ b/tools/tt-client.php
@@ -21,15 +21,30 @@
 require_once('../www/lib/nusoap.php');
 
 $soapurl    = "http://localhost/soap.php";
-$soapaction = "http://www.tux.name/tt/Translate";
+$soapaction = "http://www.tux.name/tt/AddTranslation";
 $soapclient = new nusoap_client($soapurl);
 
 $soapmsg = $soapclient->serializeEnvelope('
-<Translate xmlns="http://www.tux.name/tt">
-	<source-language>en</source-language>
-	<target-language>fr</target-language>
-	<message>hello, world</message>
-</Translate>
+<AddTranslation xmlns="http://www.tux.name/tt">
+        <auth>
+                <username>user</username>
+                <password>pass</password>
+        </auth>
+        <package>
+                <name>hello</name>
+                <version>2.3</version>
+                <homepage>http://www.gnu.org/software/hello/</homepage>
+                <download>http://localhost/distfiles/hello-2.3.tar.gz</download>
+                <license>
+                        <license-name>GNU General Public License v3 or Later</license-name>
+                        <license-url>http://localhost/license/GPLv3orLater</license-url>
+                </license>
+        </package>
+        <source-language>en</source-language>
+        <source-message>hello, world</source-message>
+        <target-language>fr</target-language>
+        <target-message>Bonjour, le monde.</target-message>
+</AddTranslation>
 ','',array(),'document', 'literal');
 
 
diff --git a/www/soap.php b/www/soap.php
index 2df9010..b036d47 100644
--- a/www/soap.php
+++ b/www/soap.php
@@ -35,6 +35,11 @@ function Suggest($language, $partial_message) {
 	}
 }
 
+function AddTranslation($auth, $package, $source_language, $source_message, $target_language, $target_message) {
+
+	return array("success" => true);
+}
+
 function Translate($source_language, $target_language, $message) {
 	global $base_url;
 
diff --git a/www/soap.wsdl b/www/soap.wsdl
index ff49fee..17c1097 100644
--- a/www/soap.wsdl
+++ b/www/soap.wsdl
@@ -50,6 +50,29 @@
 				</s:sequence>
 			</s:complexType>
 			<s:element name="TranslateResponse" type="tns:TranslateResponseType"/>
+			<s:complexType name="authType">
+				<s:sequence>
+					<s:element name="username" type="s:string"/>
+					<s:element name="password" type="s:string"/>
+				</s:sequence>
+			</s:complexType>
+			<s:complexType name="AddTranslationType">
+				<s:sequence>
+					<s:element name="auth" type="tns:authType"/>
+					<s:element name="package" type="tns:packageType"/>
+					<s:element name="source-language" type="s:string"/>
+					<s:element name="source-message" type="s:string"/>
+					<s:element name="target-language" type="s:string"/>
+					<s:element name="target-message" type="s:string"/>
+				</s:sequence>
+			</s:complexType>
+			<s:element name="AddTranslation" type="tns:AddTranslationType"/>
+			<s:complexType name="AddTranslationResponseType">
+				<s:sequence>
+					<s:element name="success" type="s:boolean"/>
+				</s:sequence>
+			</s:complexType>
+			<s:element name="AddTranslationResponse" type="tns:AddTranslationResponseType"/>
 			<s:complexType name="SuggestType">
 				<s:sequence>
 					<s:element name="language" type="s:string"/>
@@ -71,6 +94,12 @@
 	<wsdl:message name="TranslateSoapOut">
 		<wsdl:part name="parameters" element="tns:TranslateResponse"/>
 	</wsdl:message>
+	<wsdl:message name="AddTranslationSoapIn">
+		<wsdl:part name="parameters" element="tns:AddTranslation"/>
+	</wsdl:message>
+	<wsdl:message name="AddTranslationSoapOut">
+		<wsdl:part name="parameters" element="tns:AddTranslationResponse"/>
+	</wsdl:message>
 	<wsdl:message name="SuggestSoapIn">
 		<wsdl:part name="parameters" element="tns:Suggest"/>
 	</wsdl:message>
@@ -82,6 +111,10 @@
 			<wsdl:input message="tns:TranslateSoapIn"/>
 			<wsdl:output message="tns:TranslateSoapOut"/>
 		</wsdl:operation>
+		<wsdl:operation name="AddTranslation">
+			<wsdl:input message="tns:AddTranslationSoapIn"/>
+			<wsdl:output message="tns:AddTranslationSoapOut"/>
+		</wsdl:operation>
 		<wsdl:operation name="Suggest">
 			<wsdl:input message="tns:SuggestSoapIn"/>
 			<wsdl:output message="tns:SuggestSoapOut"/>
@@ -98,6 +131,15 @@
 				<soap:body use="literal"/>
 			</wsdl:output>
 		</wsdl:operation>
+		<wsdl:operation name="AddTranslation">
+			<soap:operation soapAction="http://www.tux.name/tt/AddTranslation" style="document"/>
+			<wsdl:input>
+				<soap:body use="literal"/>
+			</wsdl:input>
+			<wsdl:output>
+				<soap:body use="literal"/>
+			</wsdl:output>
+		</wsdl:operation>
 		<wsdl:operation name="Suggest">
 			<soap:operation soapAction="http://www.tux.name/tt/Suggest" style="document"/>
 			<wsdl:input>
-- 
2.11.4.GIT