Meta: Enhanced README.md, minor bug fixes

- Removed Under Construction Warning
- Added package badges and Install and Example sections to README.md
- Removed Namespacing SimpleXMLElement
- Fixed default API_DoQuery options
- Fixed API_DoQuery test

Author: tflanagan

README.md

@@ -1,11 +1,60 @@
-UNDER CONSTRUCTION - DO NOT USE
-===============================
-
 php-quickbase
 =============
 
+[![License](https://poser.pugx.org/tflanagan/quickbase/license)](https://packagist.org/packages/tflanagan/quickbase) [![Latest Stable Version](https://poser.pugx.org/tflanagan/quickbase/version)](https://packagist.org/packages/tflanagan/quickbase) [![Total Downloads](https://poser.pugx.org/tflanagan/quickbase/downloads)](https://packagist.org/packages/tflanagan/quickbase) [![Build Status](https://travis-ci.org/tflanagan/php-quickbase.svg?branch=master)](https://travis-ci.org/tflanagan/php-quickbase)
+
 A lightweight, very flexible QuickBase API
 
+Install
+-------
+```
+$ composer require tflanagan/quickbase
+```
+
+Example
+-------
+```php
+
+try {
+	$qb = new QuickBase(array(
+		'realm' => 'www',
+		'appToken' => '****'
+	));
+
+	$qb->api('API_Authenticate', array(
+		'username' => getenv('username'),
+		'password' => getenv('password')
+	));
+
+	$response = $qb->api('API_DoQuery', array(
+		'dbid' => '*****',
+		'clist' => '3.12',
+		'options' => 'num-5'
+	));
+
+	foreach($response['table']['records'] as $record){
+		$qb->api('API_EditRecord', array(
+			'dbid' => '*****',
+			'rid' => $record[3],
+			'fields' => array(
+				array( 'fid' => 12, 'value' => $record[12])
+			)
+		));
+	}
+
+	$response = $qb->api('API_DoQuery', array(
+		'dbid' => '*****',
+		'clist' => '3.12',
+		'options' => 'num-5'
+	));
+
+	var_dump($response['table']['records']);
+}catch(Exception $err){
+	var_dump($err);
+}
+
+```
+
 License
 -------
 

quickbase.php

@@ -128,7 +128,7 @@ protected function constructPayload(){
 		$this->payload = '';
 
 		if($this->parent->settings['flags']['useXML']){
-			$xmlDoc = new \SimpleXMLElement(implode('', array(
+			$xmlDoc = new SimpleXMLElement(implode('', array(
 				'<?xml version="1.0" encoding="',
 				$this->options['encoding'],
 				'"?>',
@@ -215,7 +215,7 @@ protected function transmit(){
 			throw new QuickBaseError(curl_errno($ch), curl_error($ch));
 		}
 
-		$this->xmlResponse = new \SimpleXmlIterator($response);
+		$this->xmlResponse = new SimpleXmlIterator($response);
 
 		return $this;
 	}
@@ -377,7 +377,7 @@ public static function API_DoQuery(&$query){
 		}
 
 		if(!isset($query->options['fmt']) && isset($query->parent->settings['flags']['fmt'])){
-			$query->options['returnPercentage'] = $query->parent->settings['flags']['fmt'];
+			$query->options['fmt'] = $query->parent->settings['flags']['fmt'];
 		}
 
 		if(!isset($query->options['includeRids']) && isset($query->parent->settings['flags']['includeRids'])){

tests/API_DoQuery.php

@@ -17,7 +17,8 @@
 
 $qb->api('API_DoQuery', array(
 	'dbid' => getenv('dbid'),
-	'query' => "{'3'.XEX.''}"
+	'query' => "{'3'.XEX.''}",
+	'clist' => '1.2.3.4.5'
 ));
 
 ?>