getTagByLabel( )

Gets a tag by the specified label.

Description

The getTagByLabel() function returns a Promise that resolves to a tag whose label matches the specified label.

Syntax

function getTagByLabel(label: string, options: GetTagByLabelOptions): Promise<GetTagByLabelResponse>

getTagByLabel Parameters

NAME

TYPE

DESCRIPTION

label

string

Tag label.

options

Optional

GetTagByLabelOptions

Options specifying which additional fields to return.

Returns

Return Type:

Promise<

GetTagByLabelResponse

NAME

TYPE

DESCRIPTION

tag

Tag

Tag info.

Was this helpful?

Get a tag by its label

Copy Code

1import { tags } from 'wix-blog-backend';
2
3/* Sample label value:
4 * 'my tag'
5 */
6
7export async function getTagByLabelFunction(tagId) {
8  try {
9    const result = await tags.getTagByLabel(tagId);
10    const label = result.tag.label;
11    const postCount = result.tag.postCount;
12    console.log('Retrieved result:', result);
13    return result;
14  } catch (error) {
15    console.error(error);
16  };
17}
18
19
20/* Promise resolves to:
21 * {
22 *   "tag": {
23 *     "_createdDate": "2022-07-19T10:30:03.607Z",
24 *     "_id": "32970480-e53b-46e7-b52f-fba810a0b45d",
25 *     "_updatedDate": "2022-07-19T10:30:03.607Z",
26 *     "label": "my tag",
27 *     "language": "en",
28 *     "postCount": 1,
29 *     "publishedPostCount": 1,
30 *     "slug": "my-tag",
31 *     "translationId": ""
32 *   }
33 * }
34 */

Get a tag by its label (export from backend code)

Copy Code

1import { Permissions, webMethod } from 'wix-web-module';
2import { tags } from 'wix-blog-backend';
3
4/* Sample label value:
5 * 'my tag'
6 */
7
8export const getTagByLabelFunction = webMethod(Permissions.Anyone, async (tagId) => {
9  try {
10    const result = await tags.getTagByLabel(tagId);
11    const label = result.tag.label;
12    const postCount = result.tag.postCount;
13    console.log('Retrieved result:', result);
14    return result;
15  } catch (error) {
16    console.error(error);
17  };
18});
19
20
21/* Promise resolves to:
22 * {
23 *   "tag": {
24 *     "_createdDate": "2022-07-19T10:30:03.607Z",
25 *     "_id": "32970480-e53b-46e7-b52f-fba810a0b45d",
26 *     "_updatedDate": "2022-07-19T10:30:03.607Z",
27 *     "label": "my tag",
28 *     "language": "en",
29 *     "postCount": 1,
30 *     "publishedPostCount": 1,
31 *     "slug": "my-tag",
32 *     "translationId": ""
33 *   }
34 * }
35 */
36

Get a tag by its label with additional fields

Copy Code

1import { Permissions, webMethod } from 'wix-web-module';
2import { tags } from 'wix-blog-backend';
3
4/* Sample label value:
5 * 'my tag'
6 * Sample options value:
7 * {
8 *   fieldsets:
9 *   [
10 *     'URL'
11 *   ]
12 * }
13 */
14
15export const getTagByLabelFunction = webMethod(Permissions.Anyone, async (tagId, options) => {
16  try {
17    const result = await tags.getTagByLabel(tagId, options);
18    const label = result.tag.label;
19    const postCount = result.tag.postCount;
20    const url = result.tag.url;
21    console.log('Retrieved result:', result);
22    return result;
23  } catch (error) {
24    console.error(error);
25  }
26});
27
28/* Promise resolves to:
29 * {
30 *   "tag": {
31 *     "_createdDate": "2022-07-19T10:30:03.607Z",
32 *     "_id": "32970480-e53b-46e7-b52f-fba810a0b45d",
33 *     "label": "my tag",
34 *     "slug": "my-tag",
35 *     "_updatedDate": "2022-07-19T10:30:03.607Z",
36 *     "postCount": 1,
37 *     "publishedPostCount": 1,
38 *     "language": "en",
39 *     "translationId": "",
40 *     "url": "http://https://tadasz7.wixsite.com/blog-velo-events/my-blog/tags/my-tag"
41 *   }
42 * }
43 */