Further information: DLNA TechTalk details

In the previous article on sending SMS texts, we also showed you how a simple extension can be created. You can use the "Kickstarter" extension again, but this time – instead of the "/src/sendsms/ folder – you copy the "/src/conferencecall/" folder to the "lib" folder. You need the "jQuery" library for the AJAX functionality and also need to copy it in the "lib".

The second step is creating the "eId" script."eId" means "Extension Id" and this script can be called up with "www.example.com?eID=keyword". Calling up this script interrupts the normal rendering process, which is why the pure JSON or XML data can be output.

To register a new keyword, write it in "ext_localconf.php":

$TYPO3_CONF_VARS['FE']['eID_include']['conferencecall'] = 'EXT:conferencecall/pi1/tx_conferencecall_eId.php';

The keyword "conferencecall" is now connected to the script "tx_conferencecall_eId.php".

The file "tx_conferencecall_eId.php" does not need to contain any PHP classes, but only a simple script. At the beginning of the file, you write:

if (!defined ('PATH_typo3conf')) die ('Access denied.');

And add SDK:

require_once(dirname(__FILE__) . '/../lib/sdk/conferencecall/client/ConferenceCallClient.php');
require_once(dirname(__FILE__) . '/../lib/sdk/conferencecall/data/ConferenceCallStatusConstants.php');

The POST variable "command" will represent the SDK's functions."0" will mean CreatateConference(), "1" also means CreatateConference(), but only for the planned conferences and "2" calls up AddParticipant(), etc.

switch($_POST['command']) {
   case 0:
     // Creates Ad Hoc conference
     $createConferenceResponse = null;
     try {
       $createConferenceResponse = $client->createConference($_POST['ownerID'], $_POST['name'], $_POST['description'], null, null, $_POST['duration'], $_POST['joinConfirm'], null, null);
       if(!($createConferenceResponse->getStatus()->getStatusConstant() == ConferenceCallStatusConstants::SUCCESS)) {
         $errorMessage = $createConferenceResponse->getStatus()->getStatusDescriptionEnglish();
         throw new Exception($errorMessage);
       } else {
         $a = Array (
           'Status' => 1,
           'ConfId' => $createConferenceResponse->getConferenceId()
         );
       }
     } catch(Exception $e) {
       $a = Array (
         'Status' => 0,
         'ConfId' => 0
       );
     }
     break;
 }

Since the Telekom client is created in the eId script, the Developer Center login data (user name and password) must be transferred in this script.You can do this with a TYPO3 session. In the "main" function of the "tx_conferencecall_pi1.php" file, you write:

$GLOBALS['TSFE']->fe_user]->setKey('ses','dc_username', $username);
 $GLOBALS['TSFE']->fe_user]->setKey('ses','dc_password', $password);
 $GLOBALS['TSFE']->fe_user]->setKey('ses','dc_proxy', $proxy);
 $GLOBALS['TSFE']->fe_user]->setKey('ses','dc_environment', $environment);
 $GLOBALS['TSFE']->storeSessionData();

If the login data is saved in a FlexForm, write the following before the session is processed:

$this->pi_initPIflexform();
 $username = $this->pi_getFFvalue($this->cObj->data['pi_flexform'], 'DC_Login', 'sheet1');
 $password = $this->pi_getFFvalue($this->cObj->data['pi_flexform'], 'DC_Password', 'sheet1');
 $proxy = $this->pi_getFFvalue($this->cObj->data['pi_flexform'], 'Proxy', 'sheet1');
 $env = $this->pi_getFFvalue($this->cObj->data['pi_flexform'], 'Environment', 'sheet1');

You must then create your HTML forms for all functions. There is still one JS script missing that calls up the functions from the eId script. First, you add links to the jQuery and new JavaScript file to "tx_conferencecall_pi1.php".

$GLOBALS['TSFE']->additionalHeaderData[$this->prefixId] .= '<script src="' . t3lib_extMgm::siteRelPath($this->extKey) . 'lib/jquery.js" type="text/javascript" />';
 $GLOBALS['TSFE']->additionalHeaderData[$this->prefixId] .= '<script src="' . t3lib_extMgm::siteRelPath($this->extKey) . 'pi1/tx_conferencecall_pi1.js" />';

And then you write the implementation of the required functions to the "tx_conferencecall_pi1.js".

function confcall_newParticipantInTemplate() {
   jQuery.ajax({
     url: "index.php",
     type: "POST",
     data: {
         eID: "conferencecall",
         command: 3,
         confID: jQuery("#conf_id").val(),
         firstname: jQuery("#conf_firstname").val(),
         lastname: jQuery("#conf_lastname").val(),
         phonenumber: jQuery("#conf_phone").val(),
         email: jQuery("#conf_email").val()
       },
     dataType: "json",
     success: function(response) {
         if (response.Status == 1) {
           // The participant has been added 
         } else {
           // There is an error
         }
     },
     error: function(error) {
         // AJAX-Error
     }
   });
 }

As an example, you can find the conference call extension, in which the API methods were already implemented, in the TYPO3 Extensions Repository and in the TYPO3 Forge.

Table of commercial databases

Table of free databases

 
If you have any questions regarding this overview, please leave a comment in this blog or contact Lothar Schulz. Lothar is the M2M project Scrum Master and can be contacted at lothar[dot]schulz[at]t-systems[dot]com.

Die Idee dahinter: 
Ihr baut in weniger als 8 Stunden allein oder im Team Anwendungen auf der Basis einer oder mehrerer APIs.
Welche APIs ihr verwendet, spielt keine Rolle. Ihr könnt also sowohl mit unseren Developer Garden APIs basteln als auch mit den APIs von Google, Twitter, Facebook, Dropbox, Soundcloud und Co.

Zur Stärkung werdet ihr natürlich mit Mittagessen, Snacks und Getränken versorgt.

Die Incentives

Die ersten 20 Teilnehmer erhalten eines der exklusiven Geekli.st Berlin #hackathon T-Shirts. Für die "most awesome" Anwendung gibt es obendrauf einen Amazon.de-Gutschein im Wert von 500 EUR. 

Darüber hinaus gehören die Teilnehmer des Hackathons zu den ersten, die einen Blick auf die Geekli.st API werfen dürfen. 

Die Koordinaten

Wann: 17.12.2011, 10-18 Uhr
Wo: ImmobilienScout24 ScoutLounge, Andreasstr. 10, 10243 Berlin
Anmeldung: http://www.meetup.com/Berlin-Hack-and-Tell/events/44483332/

Detailinfos zum Event:
http://www.meetup.com/Berlin-Hack-and-Tell/events/44483332/

Mehr über Geekli.st: 
http://geekli.st/about

1. Creating a basic extension

To create a “blank” extension, you can use the Kickstarter extension. The important settings in Kickstarter are “extension key” and “category.” In our example, we used “sendsms” as the extension key and selected the category “frontend plug-in”. Selecting this category ensures that the extension can be added to pages in the form of a content element (page content). Next, we created a new front-end plug-in in Kickstarter. All of the files belonging to the extension are now found in the directory /typo3conf/ext/sendsms/.

2. Connecting the PHP SDK

TYPO3 coding guidelines recommend saving all of the libraries used by an extension in the lib folder. To send text messages, the SDK only requires two directories: /src/common and /src/sendsms. These are then copied to the folder /typo3conf/ext/sendsms/lib.

Next, write  in the Include section of the PHP script “/sendsms/pi1/class.tx_sendsms_pi1.php”:

require_once(dirname(__FILE__) . '/../lib/sdk/sendsms/client/SendSmsClient.php'); 
require_once(dirname(__FILE__) . '/../lib/sdk/sendsms/data/SendSmsStatusConstants.php');

Important note:

Caching must be disabled in order to send text messages from a front-end page. You can of course do this using the global TSFE object:

$GLOBALS['TSFE']->set_no_cache();

This is not very practical, though, since the entire page with the plug-in would not be saved in the cache as a result. It’s better to include the following text in the “main” function:

$this->pi_USER_INT_obj = 1;

and then in the definition of the class, to delete the following line:

$pi_checkCHash = TRUE; 

In the “ext_localconf.php” file, replace:

t3lib_extMgm::addPItoST43($_EXTKEY, 'pi1/class.tx_yourext_pi1.php', '_pi1', 'list_type', 1);

with the following:

t3lib_extMgm::addPItoST43($_EXTKEY, 'pi1/class.tx_yourext_pi1.php', '_pi1', 'list_type', 0);

This will disable caching only for the plug-in. Now the cache has to be deleted from the TYPO3 back-end a single time (click the lightning symbol at the top edge of the page).

3. Implementing the sending of text messages

The “main” function already contains an HTML form created automatically by Kickstarter for each new plug-in.

$content = '
     <strong>This is a few paragraphs:</strong><br />
     <p>This is line 1</p>
     <p>This is line 2</p>
     <h3>This is a form:</h3>
     <form action="'.$this->pi_getPageLink($GLOBALS['TSFE']->id).'" method="POST">
         <input type="text" name="'.$this->prefixId.'[input_field]" value="'.htmlspecialchars($this->piVars['input_field']).'">
         <input type="submit" name="'.$this->prefixId.'[submit_button]" value="'.htmlspecialchars($this->pi_getLL('submit_button_label')).'">
     </form>
     <br />
     <p>You can click here to '.$this->pi_linkToPage('get to this page again',$GLOBALS['TSFE']->id).'</p>
 ';

This form is replaced by:

$content = '
     <h3>Send SMS</h3>
     <form action="' . $this->pi_getPageLink($GLOBALS['TSFE']->id) . '" method="POST">
         <label>Recipients:</label>
         <br/>
         <input type="text" name="' . $this->prefixId.'[recipients]" value="' . htmlspecialchars($this->piVars['recipients']) . '">
         <br />
         <label>Text:</label>
         <br />
         <textarea name="' . $this->prefixId . '[text]">' . htmlspecialchars($this->piVars['text']) . '</textarea>
         <br />
         <input type="submit" name="' . $this->prefixId . '[submit_button]" value="Send!">
     </form>
 ';

A Send SMS client must then be created using the Developer Center access data:

$client = new SendSmsClient('production', 'Developer Center username', 'Developer Center password');

The first parameter is for the development environment and can only have three denotations: “production,” “sandbox” or “mock.” The second and third parameters are the Developer Center log-in and password.

After the client has been created, the sendSms($recipients, $message, $originator, $flash, $account) function must be invoked.

if (isset($this->piVars['submit_button'])) {
     $client = new SendSmsClient('production', 'Developer Center username', 'Developer Center password');
     $sendSmsResponse = NULL;
     try {
         $sendSmsResponse = $client->sendSms($this->piVars['recipients'], $this->piVars['text'], 'T3Extension', 'false', NULL);
         if ($sendSmsResponse->getStatus()->getStatusConstant() == SendSmsStatusConstants::SUCCESS) {
             $content = 'Deine SMS wurde erfolgreich gesendet' . $content;
         } else {
             $errorMessage = 'The invocation of sendSms() was not successful<br />' .
                 'The error code is: ' . $sendSmsResponse->getStatus()->getStatusCode() . '<br/>' .
                 'The error message is: ' . $sendSmsResponse->getStatus()->getStatusMessage() . '<br/>';
             throw new Exception($errorMessage);
         }
     } catch(Exception $e) {
         $content = $e->getMessage() . $content;
     }
 }

Sending text messages from your own PHP scripts is that simple.

4. Examples of use

Of course, using the Send SMS API is not limited to the sending of simple text messages. The API also lets you send appointment reminders or password reset codes, all sorts of confirmations (e.g., when making online purchases) and much more. A back-end module can also be used to notify administrators of malfunctions or info updates via text message.

This extension is available in the TYPO3 Extensions Repository and in the SVN Repository in TYPO3 Forge.

For more information on the Send SMS API, please visit:
http://www.developergarden.com/apis/apis-sdks/send-sms/

But the beta-status is now over: On the MineCon in Las Vegas, the first Minecraft Convention, the release of version 1.0 of Minecraft is being celebrated.

So we join, too - not least at the instigation of the two biggest fans of Minecraft in the Developer Garden team: Daniel and Mathias, who also contributed to the current background image.

ps: The most important events of MineCon are streamed free of charge via IGN.

The first part of the TechTalk will comprise a fascinating presentation by Schlomo Schapiro, system architect and Open Source evangelist at ImmobilienScout24. The second half will be an opportunity to debate and network while enjoying free drinks and a buffet.

DevOps – eminently practical

DevOps is an IT movement whose goal it is to promote new ways of thinking in Development and Operations. The aims are:

• to create an awareness, amongst developers and administrators, of overriding, common objectives (even where individual sub-objectives and requirements within the two areas appear, at least at first glance, to differ).
• to develop solutions which can improve collaboration between developers and admins and which can spread the core ideas of agile methods to operations.

Schlomo Schapiro, system architect and Open Source evangelist at ImmobilienScout24, will introduce the subject and report on DevOps successes at ImmobilienScout24. After 2 years of agile rethinking in Development, it has been shown that the traditional separation of powers - Plan - Build - Run – is no longer practical because the requirements and expectations in both Development and Operations are continually changing and require new forms of collaboration.

The TechTalk is aimed at employees and managers in IT and web companies who are interested in agile ways of working and cross-functional teams. The presentation will be delivered in German or English. On the day, Schlomo will ask which language those attending prefer.

You can register by November 23, 2011 at the latest, either informally by sending an email to techtalk@remove-this.developergarden.com or via our XING and Facebook events.
The event starts at 7 pm. It is free of charge. There will also be free drinks and a tasty buffet.

The facts at a glance:

• What: TechTalk DevOps – eminently practical
• When: November 24, 2011 | 7 pm (registration closes: November 23, 2011)
• Where: c-base,  Rungestr. 20 10179 Berlin

For all other information about the event, go to: http://www.developergarden.com/de/apis/techtalk/techtalk-devops-mal-ganz-praktisch-24-november-2011-berlin/

We look forward to this - spending an interesting, enjoyable event with you! :-)

Am Donnerstag finden Workshops und Tutorials zu folgenden Themen statt:

• IPTV, Hyrid TV und Web TV
• Application Development for 3 Screens
• Broadband, Broadcast Convergence
• Web applications as an industry game changer

Abends geht es dann zum Social Event an den Potsdamer Platz. 

Am Freitag folgt die Konferenz mit sechs Sessions. Die Keynote "Future Media Web" hält George Wright, Head of Prototyping bei BBC R&D. Im Anschluss warten Vorträge und Paneldiskussionen zu den fünf Bereichen:

• Consumer Electronics meets Internet
• Social Media Web
• Apps Everywhere Best Practice (Panel)
• Technical Challenges
• New Media Business Models 

Details zu den Tutorials und der Konferenz findet ihr in der Programmübersicht. Die Veranstaltung ist inhaltlich breit gefächert und richtet sich sowohl an Entwickler als auch an Entscheider und Marketer.

Freitickets für das 2. Media Web Symposium

Wie im letzten Jahr haben wir auch dieses Mal ein paar Freitickets im Wert von 500 EUR für euch! Wenn ihr Interesse an einem der Tickets habt, hinterlasst bitte einen Kommentar hier im Blog, schreibt uns eine Mail an info@remove-this.developergarden.com oder kontaktiert uns über Facebook oder Twitter. 

Why are we telling you this? Simple: From now on the Developer Garden offers an Objective-C SDK that makes it even easier for you to incorporate our APIs in iOS-based apps. Of course, our SDK is fully iOS5-compatible.

The most important new features of the current version of the mobile operating system include:

• the ability to integrate iCloud Storage in apps;
• new calls or ads in AutoScout24, for example, can be shown in the Notification Center;
• Automatic Reference Counting (ARC), a garbage collector, means the developer no longer has to worry about storage management himself;
• storyboards support the creation of GUIs;
• JSON is now supported by a native API.

Details of new features for developers are available directly from Apple.

Want the AutoScout24 search engine in your own app on the iPhone? Want to integrate text messaging and MMS in an iPad app? Launch conference calls? All that is child's play with the Telekom Objective-C SDK. Along with documentation in English, you'll also find sample applications for the individual APIs.

All other information is available on our SDK site and in the comprehensive documentation.

The SDK requires iOS 5, which is supported by the iPhone models 3GS / 4 and 4s, iPod touch of the 3rd and 4th generations, and the iPad / iPad 2. The Xcode 4 development environment even lets you try out SDK without hardware, using the emulator.

Got any questions or ideas? Just write a comment here in the blog or submit something to the forum.

Sidebar gadgets are popular mini-applications which are displayed in a bar on the Windows Desktop. Gadgets can perform useful tasks or display a variety of information (e.g., CPU usage or RSS feeds).

Windows Sidebar gadgets can be implemented in various script languages. JavaScript or VBScript are available for the application logic; the graphical interfaces are created with HTML and CSS. For any interested readers, there is a good tutorial in the MSDN Magazine Blog.

It is possible to access web services in gadgets by sending out asynchronous REST requests using the XMLHttpRequest object. Three steps are needed to launch the Developer Garden Send SMS API in the Sidebar:

1. Creating the XMLHttpRequest object

There are various ways of obtaining the XMLHttpRequest object depending on the version of Internet Explorer installed (which renders the gadget in the Sidebar).

function getXMLHTTP () {
  var xmlhttp = null ;
  if (window.XMLHttpRequest) {
    xmlhttp = new XMLHttpRequest();
    if (typeof xmlhttp.overrideMimeType != 'undefined')
      xmlhttp.overrideMimeType('text/xml');
  }
  else
    if (window.ActiveXObject) {
      xmlhttp = new ActiveXObject("Microsoft.XMLHTTP");
    } else {
      throw "No XMLHTTP" ;
    }
  return xmlhttp;
}

2. Requesting the token

Authentication at the security token server is required in order to use the Developer Garden services. This takes place with the Base64-coded access data, in the form “User name: Password”. After a response is received from the security token server, the token is parsed and the SMS sending function is invoked.

function preSend(base64auth, environment, number, message, flash, originator, account) {
 
  var xmlHttp = getXMLHTTP();
  xmlHttp.open("GET","https://sts.idm.telekom.com/rest-v1/tokens/odg", true);
  xmlHttp.setRequestHeader("Authorization", "Basic "+base64auth);
  xmlHttp.send();
 
  xmlHttp.onreadystatechange = function() {
    if (xmlHttp.readyState == 4) {
      // received, OK
      if (xmlHttp.status == 200) {
        // extract the token
        var token_start = xmlHttp.responseText.indexOf("token\"");
        token_start += 8;
        var token_end = xmlHttp.responseText.indexOf("\"",token_start);
        var token = xmlHttp.responseText.substring(token_start, token_end);
       
        send(token, environment, number, message, flash, originator, account);
   
      } else {
        // error
        var response;
       
        if (xmlHttp.status == 0) {
          response = "Falscher Login?";
        } else {
          var error;
          var errorstart = xmlHttp.responseText.indexOf("message");
          if (errorstart != -1) {
            errorstart += 10;
            var errorend = xmlHttp.responseText.indexOf("\"",errorstart);
            error = xmlHttp.responseText.substring(errorstart, errorend);
          } else {
            error = "Unbekannter Fehler";
          }
          response = error;
        }
        // output the error message
        document.getElementById('message').innerHTML = response;
      }
    } else {
      // wait...
    }
  };
}

3. Invoking the SMS interface

As described in the documentation, the parameters “Environment”, “Number”, “Message”, “Flash”, “Originator” and “Account” are sent to the interface. The abovementioned token is used for authentication with the service.
After the request has successfully been sent out (readyState == 4), analysis of the API request can take place. Any errors arising must be intercepted here.

function sendmsg(token, environment, number, message, flash, originator, account) {
          
  var xmlHttp = getXMLHTTP();
  xmlHttp.open("POST","https://gateway.developer.telekom.com/p3gw-mod-odg-sms/rest/"+environment+"/sms", true);
  xmlHttp.setRequestHeader("Authorization", "TAuth realm=\"https://odg.t-online.de\", tauth_token=\""+token+"\"");
  xmlHttp.send("number="+number+"&message="+encodeURIComponent(message)+"&flash="+flash+"&originator="+originator+"&account="+account);
          
  xmlHttp.onreadystatechange = function() {
    if (xmlHttp.readyState == 4) {
      // received, OK
      // further processing
    } else {
      // wait...
    }                
  };
}

The interface aggregation is now almost complete and it remains to create a small GUI along with the XML definition file.

Functions of the gadget

The Send SMS Sidebar gadget implements all of the functions offered by the Send SMS interface. Thus, for example, any alphanumerical sender ID or, via a validation function, a real telephone number can be used as the sender.
It is also possible to decide whether to send a “normal” or “Flash SMS”. Flash SMS appear directly in the display (not in the Inbox folder) and cannot be stored.
Other functions include: Using sub- accounts, requesting credit, an address book and logging, character counting and message compression. It is also possible to send SMS to a predefined recipient list (in CSV format).

Downloading and installing

The gadget can be downloaded here. To install, launch the .gadget file.
In order to view the source text, the file extension can be changed from .gadget to .zipped and the file can be extracted.