=== GSpeech - Text To Speech Audio Accessibility using Google Translate Technology === Contributors: creative-solutions Author: creative-solutions Tags: accessibility, text to speech, text to audio, speech, player, tts Requires at least: 3.5 Tested up to: 6.4.1 Stable tag: 3.1.4 Donate link: https://gspeech.io/#pricing Author URI: hhttps://gspeech.io Add accessibility to WordPress site and auto-convert content into natural audio in 50+ languages and embed via beautiful audio players. == Description == GSpeech is a leading modern __Text-To-Speech__(TTS) Audio Solution, which uses __Google Technology__ to generate the __best audio__ and __works on all devices and browsers__! __Add accessibility to WordPress site__, and create audio version of your content in __50+ languages__(check the list in [__FAQ__](https://wordpress.org/plugins/gspeech/#which%20languages%20are%20supported%3F)) and embed via beautiful players. Empower visitors who have __visual impairment or reading disabilities__ to still completely consume your content __without the complications of reading__, and enhance the experience of users that __prefer listening to content over reading__. We use __cloud based approach__ which does not slow down your website. You can make all the setup with just a __single click__, directly from your __WP Admin Panel__. ### Useful Links: > * [Homepage](https://gspeech.io) - Online __text to audio generator__ is available. > * [Live Demo](https://gspeech.io/demos) - See GSpeech in action. Different languages. > * [Quick Start (video demo)](https://gspeech.io/docs/connect-to-wordpress-website) - Make all the setup with __one click__. > * [Support](https://gspeech.io/contact-us) - We usually respond __within an hour__. > * [Dashboard](https://gspeech.io/dashboard) - The same is integrated in __WP Admin__. > * [Screenshots](https://wordpress.org/plugins/gspeech/#screenshots) - __Live previews__ from clients websites. ### Features: * __Auto convert__ your content into engaging audio. * __50+ languages__ supported. * 3 Player Types: __Full Page Player__, __Button Player__ and __Circle Player__. * __Easy usage:__ use __[gspeech]__ or __[gspeech type=button]__ shortcode. * __2 minutes installation__. Make all the configuration with __just one click__, directly from your __WP Admin__. * __Automatically add player__ to __all pages__, where needed! * Listen to selected text. Player will appear, when you select a part of the text(__RHT Player__). * __Welcome Messages__. Play audio when user visit your website. * __Audios database__. Access to all audio files, __unlimited downloads__. * Audio is being created __only once__, then it __stored in the cloud__, for the __fast delivery__. * Automatically remove special characters and urls from the audio. * Animated banners, which informs about __TTS service active__ on the website. * __16+__ different themes and templates. * __No Google TTS Keys Requires__. We take care of all that stuff. * Dashboard integration into WordPress __WP Admin__. * Audios menu, detailed statistics, __download audio__(from WP Admin). * __Personal dashboard page__. * __Country, City, Play statistics__. * Device statistics (__desktop__, __mobile__, __tablet__). * __Fast loading time__ for a smooth experience that doesn’t affect page loading time. * __Fully mobile supported__! Player Mobile View. * __Cross browser support__. * __No server requirements__. * Nice looking design and __smooth effects__. * __Helpful and fast Support__. Please check the [__screenshots section__](https://wordpress.org/plugins/gspeech/#screenshots), to see different audio player themes and templates, and many __nice usage examples__. Also you can see detailed screenshots of GSpeech Dashboard directly in your __WP Admin__. ### Usage: > * Activate __GSpeech Cloud Console__(from WP Admin). > * To insert a __Full Page Player__, use __[gspeech]__ or __[gspeech type=full]__ shortcode. > * To insert a __Button Player__, use __[gspeech type=button]__ shortcode. > * To insert a __Circle Player__, use __[gspeech type=circle]__ shortcode. > * To exclude some part of content from the audio, add the class __nospeech__. > * For other examples please check the [__FAQ__](https://wordpress.org/plugins/gspeech/#faq). == CUSTOMER TESTIMONIAL == > __Wonderfull TTS plugin__: > "The WordPress GSpeech plugin is an amazing tool that adds a layer of accessibility and interactivity to my website in a way I never imagined would be so simple. With a number of notable features, this plugin made the user experience on my website truly exceptional. Developer solidarity and support are essential factors when evaluating any plugin or tool. The plugin's creator showed incredible solidarity in helping me create a custom player for my e-commerce content page. Your promptness in answering questions and providing technical support is commendable. I strongly recommend!" > > — Renato Araújo - Fundador PhytoCanna ### Paid Features: * __AI voices__! [See demo](https://gspeech.io). They have the star icon. Take advantage of __220+__ voices in __60+ languages__. Pick the voice, control speed and pitch, so that works best for your users and application. * __Tranlstae Blog Content__ and listen to audio version using __67 languages__ supported by __Google Translate__(please check the list in __FAQ__). * __Voice Tuning__: Personalize the __speaking pitch__ of your selected voice, up to __20__ semitones more or less from the default. Adjust your __speaking rate(speed)__ to be __4x__ faster or slower than the normal rate. * __Text Aliases__: example - teach it, to read AI as Artificial Intelligence. * __Text Panel__: Shows text panel, and caption the part of text, which is being read. * __Context Player__: Would follow the users as they scroll and allow them to control the player when it's out of view. * __Voice Panel__: Allow your users to listen audio in desired voice(differnent male/female voices). * __Translate Panel__: Give your users opportunity to on-the-fly translate audio to desired language instantly from the player(real time tranlation). We use Google Power and best neural solutions. Shows a globe icon in the player, to choose the language. * __No need to get API keys__: We are taking care for all that stuff(both TTS and Translation API keys). You just pay for your service. * __RHT Player: View 2, View 3__(translate and text panels included - see [__screenshots__](https://wordpress.org/plugins/gspeech/#screenshots)). * __Download audio__. Shows download icon in the player, __.mp3 file__ being downloaded! Unlimited downloads. * __Download statystics__! * __Seamless updates__ (cloud service updated on our side – __SaaS__, you do not need to worry about any updates). * __Detailed Analytics__. * __Play statystics__. * __Dedicated Support__. **GSpeech Video Tutorial** [youtube https://www.youtube.com/watch?v=IBeCaYtKGeQ] **GSpeech Full Player - Paid Version (using Google Translate Power)** [youtube https://www.youtube.com/watch?v=dbvmoo10_QQ] **GSpeech RHT Player(View 1,2,3) - Paid Version - read any WordPress content** [youtube https://www.youtube.com/watch?v=y2zJjNtOHqY] **GSpeech(3.X) usage terms** The __GSpeech 3.X__ version provides a Text To Speech service, which is performed by [GSpeech](https://gspeech.io). As such, the service is required to make calls to GSpeech's backend server. For using __GSpeech 3.X__ Version you should consent to our [Terms of Service](https://gspeech.io/terms). It also still provides support for the __GSpeech 2.X__ Version in the same package. ### GSpeech 2.X Features(it is also integrated in 3.X version): * Unlimited text to speech! * Read any selected text. * Welcome messages. * Place speaker wherever you want! (use {gspeech}text to speech{/gspeech} shortcode)! * Ability to set custom style and language for each the each TTS block! * 40 speaker types! * Customizable tooltip styles! * Customizable TTS block styles! * Live preview in administration panel! = GSpeech 2.X Requirements = You must have [curl](http://php.net/manual/en/book.curl.php) library enabled on your hosting, for GSpeech 2.X ### Useful Links: GSpeech 2.X > * [Live Demo](http://creative-solutions.net/wordpress/gspeech/demo) > * [Documentation](http://creative-solutions.net/wordpress/gspeech/documentation) ### Usage GSpeech 2.X - Creating Text to Speech blocks. * ***Basic structure*** - If you want the speaker to appear after the text, do the following! `{gspeech}Text to speech{/gspeech}` * ***Structure with parameters*** - You can specify custom styles and language for each Text to Speech block! `{gspeech style=2 language=en}Custom text to speech{/gspeech}` * ***Structure with all parameters will be*** `{gspeech style=2 language=en autoplay=1 speechtimeout=0 registered=0 selector=anyselector event=anyevent hidespeaker=1}welcome{/gspeech}` We keep __screenshots updated__, you can check screenshots from clients websites, and see GSpeech in action, multiple themes and templates! == Frequently Asked Questions == == Installation == 1. Go to plugins installer, search for __"gspeech"__. 2. Install the plugin. 3. Activate the plugin through the 'Plugins' menu in WordPress. 4. You will find __"GSpeech"__ menu in your WordPress admin panel. 5. __Activate Cloud Console__(it will create required widgets). __Basic Usage__ 6. Insert Full Page Player - shortcode: __[gspeech]__ or __[gspeech type=full]__. 7. Insert Button Player - shortcode: __[gspeech type=button]__. 8. Insert Circle Player - shortcode: __[gspeech type=circle]__. 9. To add as __Custom Html__: Full Player: __<div class="gsp_full_player"></div>__ 10. Custom Html, Button Player: __<div class="gsp_button_player"></div>__ 11. Custom Html, Circle Player: __<div class="gsp_circle_player"></div>__ 12. The __Read Higlighted Player__ (RHT) will ba activated automatically! == Frequently Asked Questions == = What is GSpeech? = GSpeech was created in 2013, and was providing the text to speech generation directly on your server. It uses the default voices of the [Google Translate](https://translate.google.com)! __Gspeech 3.X__ update(August 2023) is a migration the completely new __powerfull platform__: [GSpeech Dashboard](https://gspeech.io/dashboard), with support of the best AI voices(commercial plans), multiple player types, widget types(page players, welcome messages, RHT(Read Highlighted Text) player, speaking links, inactivity message or custom audio event), text aliases, audios database with ability to download, detailed analytics and statystics, and with full intefration in __WordPress Admin Panel__. = Which languages are supported? = Here is the list: __Arabic, Basque, Bengali, Bosnian, Bulgarian, Catalan, Chinese (Simplified), Chinese (Traditional), Croatian, Czech, Danish, Dutch, English (Australia), English (UK), English (India), English (United States), Estonian, Filipino, Finnish, French (Canada), French (France), Galician, German, Greek, Gujarati, Hindi, Hungarian, Icelandic, Indonesian, Italian, Japanese, Javanese, Kannada, Khmer, Korean, Latin, Latvian, Lithuanian, Malay, Malayalam, Marathi, Myanmar, Nepali, Norwegian, Polish, Portuguese (Brazil), Portuguese (Portugal), Romanian, Russian, Serbian, Sinhala, Slovak, Spanish (Spain), Spanish (United States), Sundanese (Indonesia), Swahili, Swedish, Tamil, Telugu, Thai, Turkish, Ukrainian, Urdu, Vietnamese, Yue Chinese__. = How to insert in post or page or any article? = GSpeech supports multiple ways to render the players. Once you activate the __Cloud Console__(just one click is required), the required widgets are being created automatically! __Shortcode__ 1. To insert the Full page Player anywhere in content, use __[gspeech]__ or __[gspeech type=full]__ shortcode. 2. To insert the Button Player anywhere in content, use __[gspeech type=button]__ shortcode. 3. To insert the Circle Player anywhere in content, use __[gspeech type=circle]__ shortcode. 4. To use inline shortcode, use __{gspeech id=ID}text to speech{/gspeech}__ shortcode. Where __ID__ is the _id_ od the audio widget. __Custom Html__ 1. To insert the Full Page Player anywhere in the content, use: __<div class="gsp_full_player"></div>__ 2. To insert a Button Player anywhere in content, use" __<div class="gsp_button_player"></div>__ 3. To insert a Circle Player anywhere in content, use: __<div class="gsp_circle_player"></div>__ To automatically add player on multiple pages, you can go __WP Admin->GSpeech->Cloud Console->Widgets__, you will see widget with the name __"can be used on multiple pages"__. Set __Status__ to __Enabled__. It usually works on most types of wordpress sites. You can [contact-us](https://gspeech.io/contact-us), and we will quickly configure it for your website. = How GSpeech can help to improve your wordpress accessibility? = GSpeech is a universal audio solution. It has different player types, to read out loud your articles and any content. It supports three player types, with 16+ themes. Also it has a special player called RHT player, which allows to listen to the audio of any selection from your website. See RHT section bellow. = What is Read Higlighted Text(RHT) Player, how to use it? = The __RHT Player__ is a very nice accessibility feature for any website to improve __wordpress accessibility__, which allows all your website visitors to __listen to any selected text on the webiste__. It is being activated automatically after you enable the plugin! It also shows __animated banners__, which informs website visitors about that(TTS) feature active. You can adjust one of 16 different templates, change banner position, texts, and much more. To make the configuration, go to __WP-Admin->GSpeech->Cloud Console->Widgets->RHT Player__. You will see the list of all options there. It has three views. By default it uses the __View-1__, which is a circle icon, and has built-in timeline and volume/speed options. In commercial plans you can use __View-2__ and __View-3__, where you can __translate any piece of text__, and listen to the translated content. Please check the [__screenshots section__](https://wordpress.org/plugins/gspeech/#screenshots) to see RHT player in action. = How to use Welcome Messages? = Once you activate the __Cloud Console__, the widget __Welcome Message__ is being created automatically, but it is __unpublished__ by default. To __activate__ it, please go to: __Wp-Admin->GSpeech->Cloud Console->Widgets->Welcome Message__: and set __Status__ to __Published__. __To change the welcome message__: in the same page go to __Content__ tab and change the __Content Text__. __To set up only on some pages__: Use __Allowed Urls__, set one url per row. If you need only on homepage, place only url of homepage. __To play only once__: Go to __Advanced__ tab, and set __Play Type__ to __Once per session__. = Is it FREE? = Yes! There is no audio limit fory the GSpeech 2.X(__included in the same package__), and for the GSpeech 3.X the limit is __50k__ characters __each month__! Characters are being counted on a new content __only__. Then audio file is stored on the cloud, and can be played __unlimited__ times. = GSpeech Structure! = Gspeech has a __Flexible Architecture__! Each account can have up to __ten websites__! Each of them has its settings and analytics! __Website Settings__: You specify the __Website Language__, and Default Voice. (Speed and Pitch of voices can be configured, for AI voices). The players generation is made by the __Smart Widgets Architecture__: __Widget Settings__: There are six types of widgets: __Full Page Player__, __Button Player__, __Circle Player__, __RHT Player__, __Welcome Messages__, __Custom Audio__. Main section of each widget is: **Content Settings** __1: Content Selector:__ specifies which elements should be included in the audio. HTML markup being used, which means you call elements by its html values. __Usage__: To call element by __class__, __.(dot)__ is being used. For __id__, __#__ being used. You can specify more than one element there. Separate with __,(coma)__. __NOSPEECH Class__: To exclude some part of content from the audio, add the class __nospeech__ to the containing element of that piece of content. __Greather-then >__: Can be used, to navigate to parents element. Example: __.mydiv>.parentdiv__ . __Less-then <__ Can be used, to navigate to children element. Example: __.mydiv<.childdiv__ . It will we There are two keywords: __self_class__, and __parent_class__, relative to _Render Element_. If you write __self_class__, ir will use the same conmtent, as __Render Element__ has, and for __parent_class__ it will use the parent elements content. __2: Render Element:__ specifies where to render the widget. __Usage__: To call element by __class__, __.(dot)__ is being used. For __id__, __#__ being used. __Data usage__: Structrue: __data__-{attribute_name}_:_{attribute_val} . If your element has __data-id="777"__, you can access it: __data-id:777__ . __Eq:: usage__: Structrue: __selector__::__eq__{occurrence_nummber} . If your specified element found on the page more than once, by default it will be rendered on the __first occurrence__. If you need to use on different position, use __eq::__ structure. __Example__: you have 7 _divs_ with class _mydiv_, and you need the player to be rendered on the second one. Write __.mydiv::eq2__ . __Hint__: To render widget only on the custom pages, you can set the custom class for it(for example - .my_player_wrapper, and then just add html with that class, where you need the player). In your post or page, create a custom html block, and set the class to the value, specified before. __<div class="my_player_wrapper"></div>__. You can also use __Allowed Urls__ to render only on custom pages. See __Point 6__. __3. Exclude List__: specifies which elements should be excluded from audio(HTML markup being used, which means you call elements by its html values. To call element by class, .(dot) is being used. For id, # being used). You can specify more than one element there. Separate with ,(coma). __4. Title Text__: Player Title. Will be used as top text for the __Full Page Player__, content for __Button Player__, and title for __Circle Player__. __5. Title Selector__: Use this to catch the post title, and show it in the player. __Example__: _h1_. Leave it empty, if you are using Title Text. __6. Allowed Urls__: The list of urls, where the player should be rendered. Use __*(asterisk)__ to match any character. __Example:__ use _www.example.com/blog*_ to render on all blog pages. __7. Blocked Urls__: The list of urls, where the player should not be rendered. Use __*(asterisk)__ to match any character. **Player Settings** Here you can control the player settings: __Appear Animation__(choose from 5 beautiful values), __Auto Load__(for full page player, instantly load audio, once page is loaded), __Show/Hide__: _Speed Panel, Volume Panel, Text Panel, Download Panel, Context Player Panel, Play Count Panel_. __Texts__: Here you control all texts in players. When you create any audio widget in a different language than your site's native language, all the texts will be translated __automatically__. __Translation__: Here you specify the list of available languages, and voices, for each language(paid plans). Once enabled, it will show the globe icon in the players, and will open the list of available languages. Changing the language will load the list of available voices for that language(if the multiple voices option is enabled). __Design(Preview)__: Here you adjust all the styles and themes for your player, with live preview. __Aliases__: Create the text aliases. For example you need AI to be read as Artificial Intelligence. Just add the line __ai:artificial intelligence__ . Insert one alias per row! Once you activate the __Cloud Console__, it creates the __usefull widgets__ automatically, so you can __instantly__ use __shortcodes__, __welcome messages__ and __RHT player__. There is also a widget, which can be applied to add player on multiple pages, without need to modify anything in the content. Go to __WP Admin->GSpeech->Cloud Console->Widgets__, click on __"can be used on multiple pages"__ widget, and set __Status__ to __Enabled__. You can [contact-us](https://gspeech.io/contact-us), and we will configure it for your website. = How to use with Elementor! = To use with __Elementor pages__, add the shortcode __[gspeech type=button]__(type can have values of: __full/button/circle__) anywhere in the content. By default it will include the content of parent element, where the player placed. To change the element, which content will be included in the audio, set the _custom class_ to your _elementor_ wrapper in the __advanced__ tab. For example set the class __my_gsp_player__(in elementor you put value without dot). Then go to __WP Admin->GSpeech->Cloud Console->Widgets->Shortcode Widget__(depends on the type you use, choose full/circle/button), go to __content__ tab, and set __content_selector__ to the value you specified in the _Elementor custom class_. In our example it will be __.my_gsp_player__(here dot is required). That's all. You can [contact-us](https://gspeech.io/contact-us), and we will quickly configure it for your website. = Cache plugins compatibility - WP Fastest Cache and others = Some of the cache plugins make caching of the required js files, and GSpeech stops working. Usually any cache plugin has the exclude list. To fix that, go to: __Exclude->Exclude JS__ and add the word __gspeech__. That will solve the issue. = Do I need to pay for Google TTS and Translate API keys usage? = No, all the TTS keys and the automatic real time translations are included in all packages(commercial plans). == Screenshots == 1. 3 Player types: __Full Page Player__, Button Player and Circle Player 2. Stylish Themes: compact player - on client website 3. Full Player - Black-&-Gray Theme - large audio files, translation enabled - on client website 4. Full Player - Gray-&-Blue Theme - on client website 5. Button Player - Text Panel expanded - on client website 6. RHT(Read Highlighted Text) Player(View 3), Green Template - on client website 7. Translation block - In your WP Admin - google languages list, AI voices list 8. Detailed analytics: Country, City, Device, Play statystics 9. Full Player - Custom Stylish Themes - on the client website 10. Button Player, Text Panel expanded 11. GSpeech 2.X customization(blue) 12. Full Player - Dark Theme - on client website 13. RHT Player(View 3) : Green Template - Screenshot on Iphone - on client website 14. RHT Player(View 3) - Red Template: on client website 15. Audio Page - Analytics, unlimited downloads 16. Audios Database, smart architecture of widgets 17. RHT Player(View 2) : Language panel expanded - Santa website :) 18. Full Player - Context Player opened - Screenshot on Iphone - on client website 19. Full Player - Black-&-Red Template - on client website 20. RHT Player - View 1 - Lite Blue template 21. Full Player - Black-&-Red Template - on client website 22. Full Player - Black-&-Liteblue Template - on client website 23. RHT Player(View 3) - Lite Blue Template - on client website 24. Full Player - Customization with live preview, Multiple Themes 25. RHT Player(View 1) - Black Template - on client website 26. Compact Player: Screenshot on Iphone 27. RHT Player(View 3) - Red Template: Voice Panel expanded, multiple male/female AI voices - on client website 28. Full Player - Gray-&-Green Template - on the client website 29. Dashboard in WP Admin - Settings / General tab 30. Dashboard in WP Admin - Settings / Player tab 31. Dashboard in WP Admin - Widgets menu 32. Dashboard in WP Admin - Widget config / General tab 33. Dashboard in WP Admin - Widget config / Content tab 34. Dashboard in WP Admin - Widget config / Texts tab 35. Dashboard in WP Admin - Widget config / Design tab(live preview) 36. Context Player: It follows the user during scrolling when the player is out of view 37. Circle Player - smooth effects == Changelog == = V 3.1.4 - 09/11/2023 = * Fixed session_start warning at Site Health section. * Tested on WordPress 6.4.2! = V 3.1.3 - 26/10/2023 = * Important! Fix for 3.1.X versions, issue saving posts! Fixed! = V 3.1.2 - 26/10/2023 = * WP Dashboard Homepage - improvement - added Logout Links. = V 3.1.1 - 26/10/2023 = * WP Dashboard Homepage - improvement - added Usage section. = V 3.1.0 - 25/10/2023 = * Nice Dashboard Page - Cloud Console Activation * Shortcodes supported: [gspeech] or [gspeech type=circle] * Fixed issues on dashboard inregration = V 3.0.5 - 21/10/2023 = * Fixed bug creating a second website after login! * Fixed lazy-load issue with some cache plugins * Remove urls, special characters from audio = V 3.0.4 - 06/09/2023 = * Corrections in url parameter = V 3.0.3 - 05/09/2023 = * Changed the way GSpeech renders main javascript file, to avoid strange behaviour on some websites. = V 3.0.2 - 30/08/2023 = * Fix with update(2) = V 3.0.1 - 30/08/2023 = * Fix with update = V 3.0.0 - 30/08/2023 = * Major update: support of cloud console. * Dashboard integration into WP. * Support of full page player. * Support of button player. * Support of circle player. * Fully mobile supported. * Plays statystics : charts. * Country statystics : charts. * City statystics : charts. * Device statystics : charts. * WP 6.3 tested. = V 2.8.2 - 03/04/2023 = * Tested with WordPress 6.2 = V 2.8.1 - 01/08/2022 = * Tested with WordPress 6. * Fixed "update to pro version" alert bug. = V 2.8.0 - 02/04/2021 = * important style fix in gspeech.css file, to correct bug with tooltip in last WP version! = V 2.7.32 - 28/09/2020 = * style correction. = V 2.7.31 - 10/06/2020 = * Minor fix. = V 2.7.3 - 10/06/2020 = * Important! Fixed functionality for PHP 7.x versions. = V 2.7.2 - 15/11/2019 = * Js corrections! = V 2.7.1 - 26/06/2017 = * Style corrections. = V 2.7.0 - 12/10/2016 = * Fixed bug with admin audio generation pre-defined values optimizer! = V 2.0.1 - 14/08/2015 = * Fixed issue with no-audio! = V 1.0.1 - 11/11/2013 = * Initial release!