tSMS - Temporary SMS Receiving System

Contents

1. Getting a 500 Error? Here is what you can do.

2. tSMS Installation Tutorial

3. How to setup tSMS with Plivo?

4. How to add more languages?

5. How to integrate WordPress Blogs?

6. How to add Favicon?

1. Getting a 500 Error? Here is what you can do.

If you are getting a 500 Server Error, then its very much possible that either your server is not meeting the TMail requirements OR there is some configuration issue. 

Below are the steps you can go through to check:

  1. Contact your hosting provider and ask if they have following extensions installed for you on your server:
    1. PHP >= 7.1.3 
    2. MySQL >= 5.1
    3. BCMath PHP Extension
    4. Ctype PHP Extension
    5. JSON PHP Extension
    6. Mbstring PHP Extension
    7. OpenSSL PHP Extension
    8. PDO PHP Extension
    9. Tokenizer PHP Extension
    10. XML PHP Extension
  2. Incase you are using TMail, then you will need below extensions as well:
    1. IMAP
    2. iconv
  3. Check out the logs located in storage -> logs -> (something).log and see if you can understand what the error is. This will most probably tell you what extensions are not installed properly. 


If your hosting provider comes back saying everything is installed as per the requirement and you are still getting error, check your IMAP email configuration. You can try below steps:

  1. Disable SSL for IMAP from Admin Panel
  2. Check with your hosting provider what is the hostname to connect (IMAP Hostname)

If none of the above solutions are working for you, please go ahead and create a ticket with all the details you have. Don't forget to keep the ticket private incase you have some sensitive information (like Passwords, etc).


2. tSMS Installation Tutorial

3. How to setup tSMS with Plivo?

First, you will need to install tSMS on your server. To get some help on that, checkout this article.


Once you are done installing tSMS, you can proceed to watch below video. Below video will provide you detailed steps on how you can use Plivo with tSMS.



4. How to add more languages?

How to add more languages is one of the most requested tutorial. As both tSMS and TMail now share some backend structure, this tutorial will work for both.

So, let's get straight to the point. Follow below steps to add more languages OR if you want to update any language translations :

First step is to add a folder under

resource/lang

You will see few language folders which are already created. Go ahead and create a new folder you want. Keep the folder name short, lowercase and without spaces. We will need to specify this name in another file as well to make it come on the main website.

Copy the files from "en" folder to your new folder and now start editing the files in your new folder with your new language strings.

Once you are done, goto config/app.php file and scroll down till you find below line

'locales' => ['ar', 'de', 'en', 'fr', 'hi', 'pl', 'ru'],

Now, add your new folder name in that array. For example, if your folder name is uk-en then following will be the changed line

'locales' => ['ar', 'de', 'en', 'fr', 'hi', 'pl', 'ru', 'uk-en'],

That's it!

Goto your website and you will see your new language in the language selector dropdown on top right corner :)

5. How to integrate WordPress Blogs?

From TMail v5.2, you can integrate your WordPress Blogs! You can either show blogs right on the homepage using the short-code OR you can create a new page and put the short-code to show the blogs.

 

Here is the short-code to show your WordPress Blogs on TMail: 

[blogs url="https://harshitpeer.com/blog"]

 

Below are all parameters details

url

URL of your WordPress Blog from which you want to show blog post

This is the only REQUIRED parameter. 

context Scope under which the request is made; determines fields present in response.

Default: view

One of: viewembededit

page Current page of the collection.

Default: 1

per_page Maximum number of items to be returned in result set.

Default: 10

search Limit results to those matching a string.
after Limit response to posts published after a given ISO8601 compliant date.
author Limit result set to posts assigned to specific authors.
author_exclude Ensure result set excludes posts assigned to specific authors.
before Limit response to posts published before a given ISO8601 compliant date.
exclude Ensure result set excludes specific IDs.
include Limit result set to specific IDs.
offset Offset the result set by a specific number of items.
order Order sort attribute ascending or descending.

Default: desc

One of: ascdesc

orderby Sort collection by object attribute.

Default: date

One of: authordateidincludemodifiedparentrelevancesluginclude_slugstitle

slug Limit result set to posts with one or more specific slugs.
status Limit result set to posts assigned one or more statuses.

Default: publish

categories Limit result set to all items that have the specified term assigned in the categories taxonomy.
categories_exclude Limit result set to all items except those that have the specified term assigned in the categories taxonomy.
tags Limit result set to all items that have the specified term assigned in the tags taxonomy.
tags_exclude Limit result set to all items except those that have the specified term assigned in the tags taxonomy.
sticky Limit result set to items that are sticky.

 

Note: TMail short-code uses WP JSON API for extracting blogs from your WordPress site.

6. How to add Favicon?

Upload your icon in public folder of your website and make sure you're able to access that favicon via https://yourwebsite/favicon.[png/jpg]

Once you see your favicon getting loaded in above URL, use below code and put that URL instead of [YOUR_FAVICON_URL] withj [EXT] as PNG or JPG depending upon extension of your image file.

<link rel="icon" href="[YOUR_FAVICON_URL]" type="image/[EXT]">