Developer

Developer Documentation

This page centralizes Vevioz developer resources, including the comments embed workflow and the OAuth access overview.

Open Interactive Comments Configurator

Comments Plugin

The Vevioz Comments Plugin lets you embed Vevioz-powered discussions on any website with a lightweight iframe-based integration.

Quick Start
  1. Add the comments container element to the target page.
  2. Add the loader script once on the same page.
  3. Set the discussion thread URL with the data-href attribute.
Complete Embed Code
<div class="vevioz-comments" data-href="https://example.com/article-1" data-width="100%" data-numposts="10" data-colorscheme="auto" data-locale="en-US"></div>
<script async src="https://www.vevioz.com/plugins/comments.js"></script>
Embed Parameters
Attribute Required Default Description
data-href Yes - The page URL that will be used as the comment thread key.
data-width No 100% The width of the comments container. You can use pixels or percentages.
data-numposts No 10 The number of comments to display. Supported range: 1 to 100.
data-colorscheme No auto The UI theme for the comments widget: auto, light, or dark.
data-locale No Auto from page language Force a specific interface locale, for example en or id.
Built-in Behavior
  • Automatically follows dark or light mode when data-colorscheme="auto" is used.
  • The default comment sort order is newest.
  • The default page size is 10 comments, with additional comments loaded through the load-more action.
  • Load more, post, like, unlike, and delete actions are handled with AJAX without a full page refresh.
  • The composer supports text, emoji, GIFs, stickers, image URLs or embeds, and video URLs or embeds.
  • Translate and Show original prioritize the language selector locale, then the user country setting, then the profile language, and finally IP-country auto-detection for guests or missing data through the Yandex API.
  • Guests and signed-in users can both submit comments.
  • Anti-spam rate limiting is enabled, with a maximum of 3 comments in 10 seconds per user or IP.
  • Duplicate protection is enabled, limiting identical comments in the same thread within a 10-minute window.
  • The maximum comment length is 1000 characters.
  • Media payloads are stored in the existing comment message field, without adding new database columns.
  • Data is stored in the Wo_DeveloperComments table.
Example: YouTube Page Integration
Example Code
<div class="vevioz-comments" data-href="https://www.vevioz.com/youtube" data-width="100%" data-numposts="20" data-colorscheme="auto" data-locale="en-US"></div>
<script async src="https://www.vevioz.com/plugins/comments.js"></script>

OAuth API

Use the Vevioz OAuth API to authorize applications and retrieve approved account data with GET requests.

Name Meaning Values Description Required
type Query type. get_user_data, posts_data Specifies the type of query you want to send.
limit Item limit. LIMIT Specifies the maximum number of items to return. Max: 100 | Default: 20.

How to start?

  1. Create a development application.

  2. Once the app is created, you will receive an APP_ID and APP_SECRET.
    Developer application example

  3. Start the OAuth process with this URL: https://www.vevioz.com/oauth?app_id={YOUR_APP_ID}

  4. After the end user clicks the link, they will be redirected to the authorization page.

  5. After the end user approves the application, they will be redirected back to your domain with a code GET parameter, for example: http://yourdomain/?code=XXX

  6. To exchange the authorization code for an access token, use the example below:

    PHP:
    <?php
    $app_id = 'YOUR_APP_ID'; // your application app id
    $app_secret = 'YOUR_APP_SECRET'; // your application app secret
    $code = $_GET['code']; // the GET parameter you got in the callback: http://yourdomain/?code=XXX
    
    $get = file_get_contents("https://www.vevioz.com/authorize?app_id={$app_id}&app_secret={$app_secret}&code={$code}");
    
    $json = json_decode($get, true);
    if (!empty($json['access_token'])) {
    	$access_token = $json['access_token']; // your access token
    }
    ?>
  7. After you receive the access token, call the endpoint for the data you need. Example:

    PHP:
    if (!empty($json['access_token'])) {
    	$access_token = $json['access_token']; // your access token
    	$type = "get_user_data"; // or posts_data
    	$get = file_get_contents("https://www.vevioz.com/app_api?access_token={$access_token}&type={$type}");
    }
    JSON output:
    {
      "api_status": "success",
      "api_version": "1.3",
      "user_data": {
        "id": "",
        "username": "",
        "first_name": "",
        "last_name": "",
        "gender": "",
        "birthday": "",
        "about": "",
        "website": "",
        "facebook": "",
        "twitter": "",
        "vk": "",
        "google+": "",
        "profile_picture": "",
        "cover_picture": "",
        "verified": "",
        "url": ""
      }
    }