{"id":987,"date":"2023-01-21T13:18:51","date_gmt":"2023-01-21T13:18:51","guid":{"rendered":"https:\/\/byteboxmedia.support\/?p=987"},"modified":"2023-01-21T13:51:00","modified_gmt":"2023-01-21T13:51:00","slug":"php-query-string-object","status":"publish","type":"post","link":"https:\/\/byteboxmedia.support\/docs\/game-launcher-creator-v3\/php-query-string-object\/","title":{"rendered":"PHP Query String Object"},"content":{"rendered":"

PHP Query String<\/a> objects are a powerful feature of GLCV3. They allow you to ping or send data to an online script or database and display the data received.<\/p>\n

Let’s take a look at the available settings. Please note, not all settings are available in all editions of V3.<\/p>\n

Fonts<\/h5>\n

From here you can choose the Font of the query string, font size and choose any effects such as Bold or Italic.<\/p>\n

Colors<\/h5>\n

This setting allows you to choose the color of the query string text.<\/p>\n

Script<\/h5>\n

These are the script settings.<\/p>\n

Online Query URL<\/h6>\n

This is the absolute URL to the script or file you want to liaise with.<\/p>\n

Query String Texts<\/h6>\n

Pre-Text:<\/strong> This is the text before<\/em> the result is shown.
\nPost-Text:<\/strong> This is the text after<\/em> the result is shown.
\nLoading Text:<\/strong> This is the text to display whilst the script is being processed.<\/p>\n

<\/span>Example<\/div>
Pre-Text:<\/b> There are
\nPost-Text:<\/b> Players Online<\/p>\n

After processing would display as<\/p>\n

There are 32 Players Online<\/b><\/div><\/div>\n

Additional Settings<\/h4>\n
Trigger Button<\/h5>\n

This is the internal name of the button that you can use to refresh the string. You only need to specify this if you want the user action of clicking this button to refresh the string.<\/p>\n

Execute Query String at Page Start<\/h5>\n

This will execute this query string at the start of the page<\/a>.<\/p>\n

Active Query Refresh<\/h5>\n

Setting this to ON will tell the launcher to execute the query string every X milliseconds. You need to specify the milliseconds in the box below. This is 60 per 1 second. So 30 would be half a second, 120 would be every 2 seconds. 3600 would be a minute.<\/p>\n

Unless absolutely necessary, we recommend you do not refresh the string too often. This can cause serverside and clientside issues. We recommend 3600 which equals 1 minute, although you can change this to whatever you want. Just be cautious.<\/div><\/div>\n
Image Response Active<\/h5>\n

This setting allows you to display an image<\/a> based on the response, rather than the text response received.<\/p>\n

Placeholder:<\/strong> You should tell the launcher which image to use as the placeholder image (loading image) whilst this script is processing.<\/p>\n

Tip: <\/b>We recommend creating an image object, selecting Hide on Start for its properties, then using that hidden image object as the Placeholder.<\/div><\/div>\n
Response Images<\/h5>\n

Here is the list you define of responses and images to show per response.<\/p>\n

\"\"<\/p>\n

Simply click the + button<\/strong> to add a new response. Then in the Response box, type in an expected response. Then in the Image Name, type in the relative name of the image to use from your launcher library<\/a>.<\/p>\n

\"\"<\/p>\n

For example, if the image name in your library is p1_button0a.png<\/strong> then you type that into the Image Name<\/strong> box.<\/p>\n

So now when the response online<\/strong> is received by the script, rather than displaying the text result online, it will show an image instead.<\/p>\n

You can have an unlimited amount of responses here.<\/p>\n","protected":false},"excerpt":{"rendered":"

PHP Query String objects are a powerful feature of GLCV3. They allow you to ping or send data to an online script or database and display the data received. Let’s take a look at the available settings. Please note, not all settings are available in all editions of V3. Fonts From here you can choose […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[10],"tags":[],"_links":{"self":[{"href":"https:\/\/byteboxmedia.support\/wp-json\/wp\/v2\/posts\/987"}],"collection":[{"href":"https:\/\/byteboxmedia.support\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/byteboxmedia.support\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/byteboxmedia.support\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/byteboxmedia.support\/wp-json\/wp\/v2\/comments?post=987"}],"version-history":[{"count":6,"href":"https:\/\/byteboxmedia.support\/wp-json\/wp\/v2\/posts\/987\/revisions"}],"predecessor-version":[{"id":996,"href":"https:\/\/byteboxmedia.support\/wp-json\/wp\/v2\/posts\/987\/revisions\/996"}],"wp:attachment":[{"href":"https:\/\/byteboxmedia.support\/wp-json\/wp\/v2\/media?parent=987"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/byteboxmedia.support\/wp-json\/wp\/v2\/categories?post=987"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/byteboxmedia.support\/wp-json\/wp\/v2\/tags?post=987"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}