Dokumentation?

Begonnen von Webfan, 15 Dezember 2008, 10:03:59

⏪ vorheriges - nächstes ⏩

0 Mitglieder und 1 Gast betrachten dieses Thema.

Webfan

Ich möchte meine Schnittstellen vorstellen, habe aber ein starkes Problem mit Dokumentation und so.
Ist das soweit verständlich?

Schritt 1: Registrieren und Passwort angeben unter http://www.webfan.de/API.html
Schritt 2: Download von http://www.webfan.de/Downloads-lid-WebfanAPI-SDK-37.html
              Datei in Zeile 48, 49 anpassen.
weitere Schritte:
Weblink einsenden: http://www.webfan.de/Forum-topic-97-start-msg146.html#msg146 
Kleinanzeige einsenden (md-party): http://www.webfan.de/Forum-topic-93-start-msg142.html#msg142

Zum Empfangen von Weblinks und Kleinanzeigen kann ebenfalls unter http://www.webfan.de/API.html jeweils ein Script angegeben werden. Entsprechende Scripte könnten beispielsweise so aussehen:
Weblink empfangen: http://www.webfan.de/Forum-topic-98-start-msg147.html#msg147
Kleinanzeige empfangen: http://www.webfan.de/Forum-topic-99.html

Zur Result Ausgabe können die Beispiele um die Zeile
echo $webfan->return_result();
ergänzt werden.

trulla

Was muss hier rein :
##########
Pfad zu Deinem dynamischen Script (z.B. php oder cgi) (das Script sollte entsprechend der Beschreibung arbeiten und muß die Testanfrage beantworten:
#############
ich habe getestet
http://www.pewro.de/includes/meinOrdner/meinOrdner/SDK/scriptname.php

also die gesamte url. Ich bekomme aber immer eine Fehlermeldung
;)

Anmerkung: du soltest Schnittstelle für Kleinanzeigen und Weblinks gesondert beschreiben. Mich bringt das irgendwie durcheinander. Sorry   :red:

Webfan

ZitatWas muss hier rein

ZitatWeblink empfangen: http://www.webfan.de/Forum-topic-98-start-msg147.html#msg147 (Kringel1 )
Kleinanzeige empfangen: http://www.webfan.de/Forum-topic-99.htmlKreis 2
Die Scripte aus obigen beiden Forenbeiträgen müssen gespeichert werden. WO in welcher Datei Du das machst kannst Du dort angeben, siehe Beispiel im Anhang.


Die Scripte empfangen eingesendete Weblinks/Kleinanzeigen des Netzwerkes und schicken eine Mail. Mit etwas Geschick lassen sich die Einträge direkt in der DB speichern, Beispiele dazu später.
mfg

trulla

Nochmal für dummies: Ich muss nur diese eine datei hochladen in webfan/webfan/SDK
meine user id und passwort eingeben fertig?
Im account den pfad zu meiner Datei angeben..
Im account auf speichern/testen klicken!?
Nun bekomme ich die Meldung:

Dein Script hat unsere Testanfrage nicht zufriedenstellend beantwortet!
API konnte nicht aktiviert werden!

Webfan

Langsam. Du mußt ein paar Sachen auseinanderhalten (senden/empfangen) In die Kästchen kommt NICHT der Pfad zur SDK.php
diese ist ja in includes/webfan/webfan
Zitat
meine user id und passwort eingeben fertig?
DAs Passwort kannst Du im API Kontrollzentrum festlegen (die ertse Option). In der SDK.php mußt Du es entsprechend anpassen sowie Deine Webfan USer ID.
Nach dem anpassen und hochladen der SDK.php mußt Du nun folgendes tun, Du kannst Dich dazu entschliessen der Einfachheit halber zunächst mit empfangen oder senden zu beschäftigen:

Empfangen:

ZitatWeblink empfangen: http://www.webfan.de/Forum-topic-98-start-msg147.html#msg147
Kleinanzeige empfangen: http://www.webfan.de/Forum-topic-99.html
Die erste Weblink Datei habe unter  http://www.webfan.de/test_webkatalog_32.php gepsichert, das steht bei mir im ersten Kasten. In test_webkatalog_32.php steht http://www.webfan.de/Forum-topic-98-start-msg147.html#msg147 .
Hier ist das Scrit angegeben welches die Daten Deinerseits empfangen soll.
Zitat
Dein Script hat unsere Testanfrage nicht zufriedenstellend beantwortet!
API konnte nicht aktiviert werden!
Außerdem mußt Du in den Beispielscripten noch Rückgabewert anpassen, diese steht auch im API Kontrollzentrum.

Senden:

Zum Senden von Daten müssen die Module verändert werden:
Zitat
Weblink einsenden: http://www.webfan.de/Forum-topic-97-start-msg146.html#msg146
Kleinanzeige einsenden (md-party): http://www.webfan.de/Forum-topic-93-start-msg142.html#msg142
dort noch
echo $webfan->return_result();
ergänzen, damit Du siehst was die Schnittstelle antwortet.

trulla

Zitat von: Webfan am 15 Dezember 2008, 22:59:17
In die Kästchen kommt NICHT der Pfad zur SDK.php
diese ist ja in includes/webfan/webfan
Zitat



sondern?!

Webfan

#6
Zitatsondern?!
In das Kästchen kommt der genaue Pfad zum Script welches Anzeigen/Weblinks des Netzwerkes entgegennimmt.
Zum Beispiel:
http://pewro.de/test.php bzw. http://pewro.de/test2.php

In test.php steht dann dieses Script: http://www.webfan.de/Forum-topic-98-start-msg147.html#msg147
                      bzw./und   test2.php  http://www.webfan.de/Forum-topic-99-start-msg148.html#msg148

Die beiden Demoscripte müssen angepasst werden:
- email
- und Rückgabewert und so zu finden unter http://www.webfan.de/API.html
Die Scripte senden Dir eine E-Mail wenn ein neuer Weblink/Kleinanzeige eingesendet wurden.
Später liefer ich noch Beispiele die die empfangenen Links /Anzeigen direkt in der DB speichern, der Einfachheit und wegen der Allgemeingültigkeit sollen die beiden Beispiele erstmal einfach gehalten sein und unabhängig von PMX.
Diese Optionen (mit den Kästchen) sind nur zum Empfangen von Weblinks/Kleinanzeigen von dem Netzwerk interessant.

Zum senden reicht es zunächst das Passwort festzulegen und
ZitatWeblink einsenden: http://www.webfan.de/Forum-topic-97-start-msg146.html#msg146
Kleinanzeige einsenden (md-party): http://www.webfan.de/Forum-topic-93-start-msg142.html#msg142

mfg

EDIT: Die Option mit dem Pfad zum Script ist ähnlich der OPtion bei der Anzeigenschleuder "Pfad zu Ihrem CGI Script"

trulla

Soooo..scheinbar habe ich es jetzt hinbekommen. Mein Markt wurde aktiviert. Aber, müsste ich jetzt nicht eine mail bekommen?



Webfan

ZitatAber, müsste ich jetzt nicht eine mail bekommen?
Wenn jemand eine Anzeige einträgt müsstest Du eine Mail bekommen, sofern Du den Markt aktiviert hast.
Hast Du auch die Mail Adresse angepasst?
EDIT:
Werde gleich mal eine Testanzeige aufgeben.
EDIT 2: Habe eine Testanzeige aufgegeben, Du müsstest eine Mail bekommen haben?!?

Webfan

Um die daten direkt in Deinen Markt zu integrieren ohne das Du das manuell machen mußt, kannst Du unter den Code von oben den von Deinem Anzeigenschleuder script klatschen, hierbei folgendes modifizieren:

$username    = $daten['api_SubUser'];
$firstname =$daten['api_SubUser'];
$telephone    = '';
$zipcode ='';
$areacode ='';
$country = '';
$street = '';
$town =$daten['town'];
$email =$daten['email'];
$fax ='';
$link = '';
$category ='Sonstiges';
$subcategory = '';
$categoryID  =$daten['catID'];
$subcategoryID =$daten['catID'];
$adverttype  ='';
$busitype ='';
$advertheader =$daten['title'];
$advertbody = $daten['description'];
$adults_only ='OFF';
$advertID =$daten['id'];
$action = '';
$xml = '';

trulla


trulla

hoppla...das bezog sich jetzt auf; mail bekommen.

Nächster Schritt
:
Du meinst den gesamten anzeigenschleuderdingens.php unter mein webfandingens.php anfügen?

Webfan

ZitatDu meinst den gesamten anzeigenschleuderdingens.php unter mein webfandingens.php anfügen?
Ja genau das meine ich, lediglich den Abschnitt oben mußt Du anpassen, also diesen Abschnitt
$username    = mxAddSlashesForSQL(strip_tags($_POST["username"]));
$firstname =mxAddSlashesForSQL(strip_tags($_POST["firstname"]));
$telephone    = mxAddSlashesForSQL(strip_tags($_POST["telephone"]));
$zipcode = mxAddSlashesForSQL(strip_tags($_POST["zipcode"]));
$areacode = mxAddSlashesForSQL(strip_tags($_POST["areacode"]));
$country = mxAddSlashesForSQL(strip_tags($_POST["country"]));
$street = mxAddSlashesForSQL(strip_tags($_POST["street"]));
$town = mxAddSlashesForSQL(strip_tags($_POST["town"]));
$email = mxAddSlashesForSQL(strip_tags($_POST["email"]));
$fax = mxAddSlashesForSQL(strip_tags($_POST["fax"]));
$link = mxAddSlashesForSQL(strip_tags($_POST["link"]));
$category = mxAddSlashesForSQL(strip_tags($_POST["category"]));
$subcategory = mxAddSlashesForSQL(strip_tags($_POST["subcategory"]));
$categoryID  = mxAddSlashesForSQL(strip_tags($_POST["categoryID"]));
$subcategoryID = mxAddSlashesForSQL(strip_tags($_POST["subcategoryID"]));
$adverttype  = mxAddSlashesForSQL(strip_tags($_POST["adverttype"]));
$busitype = mxAddSlashesForSQL(strip_tags($_POST["busitype"]));
$advertheader = mxAddSlashesForSQL(strip_tags($_POST["advertheader"]));
$advertbody = mxAddSlashesForSQL(strip_tags($_POST["advertbody"]));
$adults_only = mxAddSlashesForSQL(strip_tags($_POST["adults_only"]));
$advertID = mxAddSlashesForSQL(strip_tags($_POST["advertID"]));
$action = mxAddSlashesForSQL(strip_tags($_POST["action"]));
$xml = mxAddSlashesForSQL(strip_tags($_POST["xml"]));
$lastError ='';

ersetzen durch was ich oben gepostet habe.

Jenachdem wo Du die Datei nun allerdings hast mußt Du den Pfad anpassen
require('../../config.php');
ersetzen durch
require('config.php');

Wenn test.php im PragmamX root liegt (bzw. nochmal am besten dorthin kopieren).

mfg

trulla

sorry, irgendwas läuft bei mir noch schief.  :red:  Ich bekomme zwar insgesamt 3 mails;aber bei mirkommt keine Anzeigean. Muss jetzt weg.Werde mich am nachmittag/abends weiter befassen.

Webfan

Probiere mal wenn Du wieder da bist statt
$adults_only    ='OFF';
lieber
$adults_only    ='off';

Ansonsten, siehe Mail.
mfg

Webfan

#15
Habe die Schnittstelle nun erfolgreich bei Dir eingerichtet. Juchhu, alles funktioniert, auch das löschen der Kleinanzeigen funzt.
Du hattest das Weblinks Beispiel statt Kleinanzeigen verwendet und SDK.php unter einem anderen Pfad gespeichert. Nun funzt es. Man kann nun Kleinanzeigen in beiden Märkten inserieren und löschen.

Wer Interesse an der Teilnahme am Kleinanzeigen- oder Weblinksnetzwerk hat dem helfe ich gerne bei der Installation, sowie ich Zeit habe.

EDIT: Bei Bedarf kannst Du die Zeile
mail(...
in der Dingens.php auskommentieren mit // davor, wenn Du nicht jedesmal eine Mail wünscht.

EDIT2: Ich sehe das die Doku noch besch*** ist.  :gruebel:

trulla

 :smile:
Klasse läuft alles super! Ich hoffe, dass sich noch einige user unserem Netzwerk anschliessen. :thumbup: