1.2.14

Added Font Color and Background Color Capabilities

.gitignore

@@ -1,3 +1,5 @@
-vendor*
+/vendor*
 /books.fw.png
 /datatypes.fw.png
+/styles.fw.png
+/.gitignore

CHANGELOG.md

@@ -0,0 +1,124 @@
+# Changelog
+## 1.2.14 (2022-06-10)
+* added example [JS array to Excel (AJAX)](https://github.com/shuchkin/simplexlsxgen#js-array-to-excel-ajax)
+
+## 1.2.13 (2022-06-01)
+* setColWidth(num_col_started_1, size_in_chars) - set column width
+
+## 1.2.12 (2022-05-17)
+* Vertical align (tags top,middle,bottom) `<bottom>12345</bottom>`
+
+## 1.2.11 (2022-05-01)
+* Row height `<style height="50">Custom row height 50</style>`
+
+
+## 1.2.10 (2022-04-24)
+* Added colors `<style color="#FFFF00" bgcolor="#00FF00">Yellow text on blue background</style>`, thx [mrjemson](https://github.com/mrjemson)
+
+## 1.1.12 (2022-03-15)
+* Added `$xlsx->mergeCells('A1:C1')`
+
+## 1.1.11 (2022-02-05)
+* sheet name maximum length is 31 chars, mb_substr used now
+* license fixed
+
+## 1.1.10 (2022-02-05)
+* namespace added, use Shuchkin\SimpleXLSXGen
+
+## 1.0.23 (2022-02-01)
+* fixed dates if year < 1900 and time only cells, thx [fapth](https://github.com/shuchkin/simplexlsxgen/issues/51)   
+
+## 1.0.22 (2021-10-29)
+* Escape \x00 and \x0B (vertical tab)
+
+## 1.0.21 (2021-09-03)
+*  Fixed saveAs / downloadAs / etc methods more than once
+
+## 1.0.20 (2021-07-29)
+* Fixed sheet names duplicates (Page, Page (1), Page (2)...) 
+
+## 1.0.19 (2021-07-28)
+* Fixed sheet names duplicates 
+
+## 1.0.18 (2021-07-28)
+* Fixed email regex
+
+## 1.0.17 (2021-07-28)
+* Fixed &quot; and &amp; in sheets names
+
+## 1.0.16 (2021-07-01)
+* Fixed &quot;&amp;&quot; in hyperlinks
+
+## 1.0.15 (2021-06-22)
+* Fixed *mailto* hyperlinks detection
+
+## 1.0.14 (2021-06-08)
+* Added *mailto* hyperlinks support (thx Howard Martin)
+```php
+SimpleXLSXGen::fromArray([
+	['Mailto hyperlink', '<a href="mailto:sergey.shuchkin@gmail.com">Please email me</a>']
+])->saveAs('test.xlsx');
+```
+## 1.0.13 (2021-05-29)
+* Fixed hyperlinks in several sheets
+* Added [Opencollective donation link](https://opencollective.com/simplexlsx)
+
+## 1.0.12 (2021-05-19)
+* Fixed hyperlink regex
+
+## 1.0.11 (2021-05-14)
+* Fixed 0.00% format, thx [marcrobledo](https://github.com/shuchkin/simplexlsxgen/pull/34), more examples in README.md
+
+## 1.0.10 (2021-05-03)
+Stable release
+
+* Added hyperlinks and minimal formatting
+
+## 0.9.25 (2021-02-26)
+* Added PHP Datetime object values in a cells
+
+## 0.9.24 (2021-02-26)
+* Percent support
+
+
+## 0.9.23 (2021-01-25)
+* Fix local floats in XML
+
+## 0.9.22 (2020-11-04)
+* Added multiple sheets support, thx [Savino59](https://github.com/Savino59), class ready for extend now
+ 
+## 0.9.21 (2020-10-17)
+* Updated images
+
+## 0.9.20 (2020-10-04)
+* Disable type detection if string started with chr(0)
+
+## 0.9.19 (2020-08-23)
+* Numbers like SKU right aligned now
+
+## 0.9.18 (2020-08-22)
+* Fixed fast shared strings index
+ 
+## 0.9.17 (2020-08-21)
+* Fixed real numbers in 123.45 format detection, fast shared strings index (thx fredriksundin)
+ 
+## 0.9.16 (2020-07-29)
+* Fixed time detection in HH:MM:SS format
+
+## 0.9.15 (2020-07-14)
+* Escape of shared strings for special chars in cells [#1](https://github.com/shuchkin/simplexlsxgen/issues/1) 
+
+## 0.9.14 (2020-05-31)
+* Fixed num2name A-Z,AA-AZ column names, thx Ertan Yusufoglu
+
+## 0.9.13 (2020-05-21)
+* If string more 160 chars, save as inlineStr
+
+## 0.9.12 (2020-05-21)
+* Readme fixed
+
+## 0.9.11 (2020-05-21)
+* Removed XML unimportant attributes
+
+## 0.9.10 (2020-05-20)
+* Initial release

README.md

@@ -1,12 +1,14 @@
-# SimpleXLSXGen class 0.9.25 (Official)
-[<img src="https://img.shields.io/endpoint.svg?url=https%3A%2F%2Fshieldsio-patreon.herokuapp.com%2Fshuchkin" />](https://www.patreon.com/shuchkin) [<img src="https://img.shields.io/github/license/shuchkin/simplexlsxgen" />](https://github.com/shuchkin/simplexlsxgen/blob/master/license.md) [<img src="https://img.shields.io/github/stars/shuchkin/simplexlsxgen" />](https://github.com/shuchkin/simplexlsxgen/stargazers) [<img src="https://img.shields.io/github/forks/shuchkin/simplexlsxgen" />](https://github.com/shuchkin/simplexlsxgen/network) [<img src="https://img.shields.io/github/issues/shuchkin/simplexlsxgen" />](https://github.com/shuchkin/simplexlsxgen/issues)
+# SimpleXLSXGen
+[<img src="https://img.shields.io/github/license/shuchkin/simplexlsxgen" />](https://github.com/shuchkin/simplexlsxgen/blob/master/license.md) [<img src="https://img.shields.io/github/stars/shuchkin/simplexlsxgen" />](https://github.com/shuchkin/simplexlsxgen/stargazers) [<img src="https://img.shields.io/github/forks/shuchkin/simplexlsxgen" />](https://github.com/shuchkin/simplexlsxgen/network) [<img src="https://img.shields.io/github/issues/shuchkin/simplexlsxgen" />](https://github.com/shuchkin/simplexlsxgen/issues)
 
-Export data to Excel XLSX file. PHP XLSX generator. No external tools and libraries.<br/>
-(!) XLSX reader [here](https://github.com/shuchkin/simplexlsx).  
+Export data to Excel XLSX file. PHP XLSX generator. No external tools and libraries.  
+- XLSX reader [here](https://github.com/shuchkin/simplexlsx)
+- XLS reader [here](https://github.com/shuchkin/simplexls)
+- CSV reader/writer [here](https://github.com/shuchkin/simplecsv)
 
-**Sergey Shuchkin** <sergey.shuchkin@gmail.com> 2020-2021<br/>
+**Sergey Shuchkin** <sergey.shuchkin@gmail.com> 2020-2022<br/>
 
-*Hey, bro, please ★ the package for my motivation :)* 
+*Hey, bro, please ★ the package for my motivation :) and [donate](https://opencollective.com/simplexlsx) for more motivation!* 
 
 ## Basic Usage
 ```php
@@ -15,8 +17,8 @@ $books = [
     [618260307, 'The Hobbit', 'J. R. R. Tolkien', 'Houghton Mifflin', 'USA'],
     [908606664, 'Slinky Malinki', 'Lynley Dodd', 'Mallinson Rendel', 'NZ']
 ];
-$xlsx = SimpleXLSXGen::fromArray( $books );
-$xlsx->saveAs('books.xlsx'); // or downloadAs('books.xlsx')
+$xlsx = Shuchkin\SimpleXLSXGen::fromArray( $books );
+$xlsx->saveAs('books.xlsx'); // or downloadAs('books.xlsx') or $xlsx_content = (string) $xlsx 
 ```
 ![XLSX screenshot](books.png)
 
@@ -42,50 +44,123 @@ $data = [
     ['Time','02:38:00'],
     ['Datetime PHP', new DateTime('2021-02-06 21:07:00')],
     ['String', 'Long UTF-8 String in autoresized column'],
+    ['Hyperlink', 'https://github.com/shuchkin/simplexlsxgen'],
+    ['Hyperlink + Anchor', '<a href="https://github.com/shuchkin/simplexlsxgen">SimpleXLSXGen</a>'],
     ['RAW string', "\0".'2020-10-04 16:02:00']
 ];
-SimpleXLSXGen::fromArray( $data )->saveAs('datatypes.xlsx');
+Shuchkin\SimpleXLSXGen::fromArray( $data )->saveAs('datatypes.xlsx');
 ```
 ![XLSX screenshot](datatypes.png)
-### Fluid examples
+
+### Formatting
 ```php
-SimpleXLSXGen::fromArray( $books )->downloadAs('table.xlsx'); // output to browser for download
-SimpleXLSXGen::fromArray( $books )->addSheet( $books2 )->download(); // multiple sheets
-(new SimpleXLSXGen)->addSheet( $books, 'Modern style')->save();
+$data = [
+    ['Normal', '12345.67'],
+    ['Bold', '<b>12345.67</b>'],
+    ['Italic', '<i>12345.67</i>'],
+    ['Underline', '<u>12345.67</u>'],
+    ['Strike', '<s>12345.67</s>'],
+    ['Bold + Italic', '<b><i>12345.67</i></b>'],
+    ['Hyperlink', 'https://github.com/shuchkin/simplexlsxgen'],
+    ['Italic + Hyperlink + Anchor', '<i><a href="https://github.com/shuchkin/simplexlsxgen">SimpleXLSXGen</a></i>'],
+    ['Green', '<style color="#00FF00">12345.67</style>'],
+    ['Bold Red Text', '<b><style color="#FF0000">12345.67</style></b>'],
+    ['Blue Text and Yellow Fill', '<style bgcolor="#FFFF00" color="#0000FF">12345.67</style>'],
+    ['Left', '<left>12345.67</left>'],
+    ['Center', '<center>12345.67</center>'],
+    ['Right', '<right>Right Text</right>'],
+    ['Center + Bold', '<center><b>Name</b></center>'],
+    ['Row height', '<style height="50">Row Height = 50</style>'],
+    ['Top', '<style height="50"><top>Top</top></style>'],
+    ['Middle + Center', '<style height="50"><middle><center>Middle + Center</center></middle></style>'],
+    ['Bottom + Right', '<style height="50"><bottom><right>Bottom + Right</right></bottom></style>'],
+    ['<center>MERGE CELLS MERGE CELLS MERGE CELLS MERGE CELLS MERGE CELLS</center>', null],
+];
+SimpleXLSXGen::fromArray( $data )
+    ->setDefaultFont( 'Courier New' )
+    ->setDefaultFontSize( 14 )
+    ->setColWidth(1, 35) // 1 - num column, 35 - size in chars
+    ->mergeCells('A20:B20')
+    ->saveAs('styles_and_tags.xlsx');
 ```
-### Old school, multiple sheets
+![XLSX screenshot](styles.png)
+
+### More examples
 ```php
+// Fluid interface, output to browser for download
+Shuchkin\SimpleXLSXGen::fromArray( $books )->downloadAs('table.xlsx');
+
+// Fluid interface, multiple sheets
+Shuchkin\SimpleXLSXGen::fromArray( $books )->addSheet( $books2 )->download();
+
+// Alternative interface, sheet name, get xlsx content
+$xlsx_cache = (string) (new Shuchkin\SimpleXLSXGen)->addSheet( $books, 'Modern style');
+
+// Classic interface
+use Shuchkin\SimpleXLSXGen
 $xlsx = new SimpleXLSXGen();
 $xlsx->addSheet( $books, 'Catalog 2021' );
 $xlsx->addSheet( $books2, 'Stephen King catalog');
 $xlsx->downloadAs('books_2021.xlsx');
+exit();
 ```
-### Debug
+### JS array to Excel (AJAX)
+```php
+<?php // array2excel.php
+if (isset($_POST['array2excel'])) {
+    require __DIR__.'/simplexlsxgen/src/SimpleXLSXGen.php';
+    $data = json_decode($_POST['array2excel'], false);
+    \Shuchkin\SimpleXLSXGen::fromArray($data)->downloadAs('file.xlsx');
+    return;
+}
+?>
+<html lang="en">
+<head>
+    <title>JS array to Excel</title>
+</head>
+<script>
+
+function array2excel() {
+    var books = [
+        ["ISBN", "title", "author", "publisher", "ctry"],
+        [618260307, "The Hobbit", "J. R. R. Tolkien", "Houghton Mifflin", "USA"],
+        [908606664, "Slinky Malinki", "Lynley Dodd", "Mallinson Rendel", "NZ"]
+    ];
+    var json = JSON.stringify(books);
+
+    var request = new XMLHttpRequest();
+
+    request.onreadystatechange = function () {
+        if (this.readyState === 4) {
+            if (this.status === 200) {
+                var file = new Blob([this.response], {type:  "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"});
+                var fileURL = URL.createObjectURL(file);
+                window.open(fileURL);
+            } else {
+                alert("Error: " + this.status + "  " + this.statusText);
+            }
+        }
+    }
+    request.open('POST', "array2excel.php");
+    request.responseType = "blob";
+    request.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");
+    request.send("array2excel=" + encodeURIComponent(json));
+}
+</script>
+<body>
+<input type="button" onclick="array2excel()" value="array2excel" />
+</body>
+</html>
+```
+
+## Debug
 ```php
 ini_set('error_reporting', E_ALL );
 ini_set('display_errors', 1 );
 
 $data = [
     ['Debug', 123]
-]
-SimpleXLSXGen::fromArray( $data )->saveAs('debug.xlsx');
+];
+
+Shuchkin\SimpleXLSXGen::fromArray( $data )->saveAs('debug.xlsx');
 ```
-
-
-## History
-v0.9.25 (2021-02-26) Added PHP Datetime object values in a cells
-v0.9.24 (2021-02-26) * Percent<br/>
-v0.9.23 (2021-01-25) Fix local floats in XML<br/>
-v0.9.22 (2020-11-04) Added multiple sheets support, thx [Savino59](https://github.com/Savino59), class ready for extend now<br/> 
-v0.9.21 (2020-10-17) Updated images<br/>
-v0.9.20 (2020-10-04) Disable type detection if string started with chr(0)<br/>
-v0.9.19 (2020-08-23) Numbers like SKU right aligned now<br/>
-v0.9.18 (2020-08-22) Fixed fast shared strings index<br/> 
-v0.9.17 (2020-08-21) Fixed real numbers in 123.45 format detection, fast shared strings index (thx fredriksundin)<br/> 
-v0.9.16 (2020-07-29) Fixed time detection in HH:MM:SS format<br/>
-v0.9.15 (2020-07-14) escape of shared strings for special chars in cells [#1](https://github.com/shuchkin/simplexlsxgen/issues/1) <br/>
-v0.9.14 (2020-05-31) fixed num2name A-Z,AA-AZ column names, thx Ertan Yusufoglu<br/>
-v0.9.13 (2020-05-21) if string more 160 chars, save as inlineStr<br/>
-v0.9.12 (2020-05-21) readme fixed<br/>
-v0.9.11 (2020-05-21) removed XML unimportant attributes<br/>
-v0.9.10 (2020-05-20) initial release

composer.json

@@ -17,6 +17,7 @@
     ]
   },
   "require": {
+    "php": ">=5.4",
     "ext-mbstring": "*",
     "ext-zlib": "*"
   }

license.md

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2014 Lukas Martinelli
+Copyright (c) 2020-2022 Sergey Shuchkin sergey.shuchkin@gmail.com
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal