Function and usage of get_links() in wordpress


Answers ( 1 )


    The get_links() function in WordPress is used to retrieve and display links associated with a specific category by ID. It offers a range of parameters to customize the output, including formatting options and sorting preferences. Below is a detailed explanation of the function and its parameters:


    • Purpose: Gets the links associated with a specified category by ID.


    • The function can be used in conjunction with get_bookmarks(), which offers more detailed control over link retrieval.


    1. $category (int, optional): Specifies the category ID of the links to retrieve.

      • Default: -1 (which means it uses all categories if no specific category is supplied).
    2. $before (string, optional): HTML content to output before each link.

      • Default: '' (empty string).
    3. $after (string, optional): HTML content to output after each link.

      • Default: '<br />' (line break).
    4. $between (string, optional): HTML content to output between the link/image and its description. Not used if no image or $show_images is true.

      • Default: ' ' (a space).
    5. $show_images (bool, optional): Specifies whether to show images (if they are defined for the links).

      • Default: true.
    6. $orderby (string, optional): Determines the order in which the links are displayed. Acceptable values include 'id', 'name', 'url', 'description', 'rating', or 'owner'. An underscore before the name reverses the order. 'rand' returns links in a random order.

      • Default: 'name'.
    7. $show_description (bool, optional): Determines whether to show the description of each link. It's applicable when $show_images is false or not defined.

      • Default: true.
    8. $show_rating (bool, optional): Whether to show rating stars or characters.

      • Default: false.
    9. $limit (int, optional): Limits the number of entries displayed. If not specified, all entries are shown.

      • Default: -1 (no limit).
    10. $show_updated (int, optional): Specifies whether to show the last updated timestamp for each link.

      • Default: 1 (true).
    11. $display (bool, optional): Determines whether to display the results directly on the page or return them for further processing.

      • Default: true.

    Return Value:

    • Type: null|string
    • The function returns the formatted links as a string, or null if there are no links to display.

    Sample Usage:

    // Display links from a specific category with custom formatting
    get_links(10, '<p>', '</p>', ' - ', true, 'name', true, false, 10, 1, true);

    In this example, links from category ID 10 are displayed. Each link is preceded by a paragraph tag, followed by another paragraph tag, with a dash between the link and its description. Images are shown, links are ordered by name, descriptions are displayed, rating is not shown, the limit is set to 10 links, updated timestamps are shown, and the results are displayed directly.

Leave an answer