Shortcodes

Short Codes are used to embed single files, file lists or upload forms (Pro) into Posts or Pages.

A shortcode looks like this:
[wpfilebase tag="file" id=2 /]
This would insert the file with the ID 2 using the default file template (see Templates)

Parameters

Here’s a list of all available shortcode parameters. Note that some parameters are only available for certain tags.

Parameter NameDescription
tag (required)Possible values:
list
file
fileurl
attachments
browser
form (Pro)
idFile ID, Category ID or Embedded Form Tag (Pro)
pathRelative File or Category Path (either id or path can be specified, but not both parameters!)
tplTemplate Tag. If omitted default templates are used.
sortFile Property to sort files. You can sort by the following parameters:file_display_name
file_name
file_version
file_hits
file_size
file_date
file_last_dl_time
file_path
file_id
file_category_name
file_category
file_description
file_author
file_license
file_post_id
file_added_by
Add > prefix to sort descending (< is ascending, by default), e.g: [wpfilebase tag=list sort=">file_size" /] creates a file list where large files come first. You can sort by multiple files, seperate terms by comma (,). Example “>file_hits,<file_name”
showcats0/1 – To show categories in file lists, files will be grouped by category. Default is 0
sortcatsFor lists. Property to sort categories by (ignored if showcats=0)cat_name
cat_folder
cat_description
cat_path
cat_id
cat_parent
cat_num_files
cat_num_files_total
cat_order
numNumber. Limits the number of files in file lists (when pagenav is enabled, this is the number of files per page)
pagenav0/1 – Wether to show the page navigation if list is paginated.
linktextFor tag=fileurl only. Text for the link.
If linktext is empty or not given, the shortcode will just output the file URL (http://www….com/…/file.pdf). Otherwise it generates a HTML <a> element: <a href=”http://www….com/…/file.pdf”>linktext</a>
searchPro only. Search term to filter files in lists. Only matching files will be displayed.

Files and categories can either be selected by their id [wpfilebase tag=file id=123] or their path [wpfilebase tag=file path=sample_category/myfile.pdf] but not both: [wpfilebase tag=file id=123 path=sample_category/myfile.pdf]

 List

Generates sortable, paginated and searchable file lists.

[wpfilebase tag="list" id={category id} path="{category path}" tpl="{list template tag}" sort="{file_property}" showcats={0/1} sortcats="{cat_property}" num="{page limit}" pagenav="{0/1}" search="{searchterm}" /]

Either the id parameter or path parameter or none of both has to be specified. If none is given all categories are included. To include multiple categories seperate their IDs by comma: [wpfilebase tag="list" id="1,2,3" /]

If tpl is not given, default list template is used.

Default sortings (can be set in WP-Filebase Settings) are used if sorting parameters are omitted.

Use the search parameter to filter the list. Enter any search term like you would do it when you are using the search widget. The search filter includes all file meta data (name, descrtiption tags) and – if enabled – ID3 tags and also indexed keywords of PDF files. See Search

File

Embeds a single file using default or custom templates.

[wpfilebase tag="file" id={file_id} path="{file path}" tpl="{template tag}" /]

Either the id or the path parameter must be specified. If tpl is not given, default file template is used.

File URL

Inserts a download link for a file.
[wpfilebase tag="fileurl" id={file_id} linktext="{text of the link}" /]
Either the id or the path parameter must be specified. If linktext is set, it generates a hyperlink that links to the file. If not, it just gives out the URL of the file so you can use it in custom <a> tags like:
<a href="[wpfilebase tag=fileurl id={file_id} /]">...Linking text or HTML elements...</a>
Note that you can’t use double quotes ( ” ) when the shortcode is placed inside a HTML attribute like in previous sample. To open files in a new tab, add the target=”_blank” attribute:
<a href="[wpfilebase tag=fileurl id={file_id} /]" target="_blank">...Linking text or HTML elements...</a>

Attachments

This shortcode lists files attached to the current post. You can optionally specify a list template.

[wpfilebase tag=attachments tpl="{list template tag}" /]

Browser

Inserts an AJAX tree view to browse files like the File Browser

[wpfilebase tag="browser" id={category id} path="{category path}" /]

With id or path you can set the browser’s root category. If both paremeters are not specified the File Browser will show all categories.

Form

WP-Filebase Pro only. Embeds a form to upload files. Forms must previously be created with the backend WP-Filebase -> Embeddable Forms.

[wpfilebase tag="form" id="{form tag}" /]

In this case id ist not a number but the tag of the form to embed. See Embeddable Forms for details.

Search

With the search parameter you can filter results in file lists.

The following shortcode gives you a list of all files (including all categories) that have 3d in the name, description, ID3, etc. or are tagged with 3d:

[wpfilebase tag="list" search="3d" /]

You can additionally provide the template parameter, to use a different list template and/or set one or more categories to search in:

[wpfilebase tag="list" id="5, 67, {cat_id..}" tpl="{template tag}" search="3d" /]

This following shortcode illustrates the use of multiple search terms:

[wpfilebase tag="list" search="hotfix zip filebase" /]

This search matches all files with hotfix, zip and filebase somewhere in name or other meta data. Sample matching file name: “wp-filebase-hofix.zip”. The order of the space-separated terms does not matter.

Since WP-Filebase Pro 0.3.0.03, you can exclude files with matching keywords. Append the exlude operator (dash/hyphen-minus -) to the keyword that should be excluded from search:
[wpfilebase tag="list" search="filebase -hotfix" /]
This shortcode would lists all files matching on “filebase”, but don’t have “hotfix” in their names (or any other fields)

Addionally, you can use wildcards:

To search for ZIP files:
[wpfilebase tag="list" search="filebase *.zip" /]

Search for files with names beginning with “wp-filebase…”:
[wpfilebase tag="list" search="wp-filebase*" /]

Exclude ZIP files from search (exlude operator “-” combined with wildcard):
[wpfilebase tag="list" search="filebase -*.zip" /]

Note that search=”*filebase*” equals to search=”filebase”. That’s because if no wildcard is used, terms are automatically wrapped by them.

52 thoughts on “Shortcodes

  1. Mustafa says:
    VA:F [1.9.22_1171]
    Rating: 0 (from 2 votes)

    Merhaba:
    Benim sorum şu ki: web sayfasında abonelere dosya yükleme imkanı vermek istiyorum. Aboneler dosya yüklerken kategorilere göre yükleme imkanı vermek istiyorum. Nasıl yapabilirim. Yardımcı olursanız sevinirim. Teşekkür ederim.

  2. Tomo says:
    VA:F [1.9.22_1171]
    Rating: +2 (from 2 votes)

    Hi,
    descending file sorting doesn’t work.
    I want to show list of files in a way that the newest file is on top. I’m using shortcodes, As soon as do this: sort=">file_id", the list is not showing, If I do this: sort="file_id", it works, but ascending. I do not want that. So I presume something is wrong with the character “>”.
    Need help

    1. Adrian Jefferies says:
      VA:F [1.9.22_1171]
      Rating: 0 (from 0 votes)

      I had the same problem, and worked around it by using the ASCII character >

      I think that the greater than sign is being interpreted as the start of HTML markup, so the shorcode breaks.

      1. Adrian Jefferies says:
        VA:F [1.9.22_1171]
        Rating: 0 (from 0 votes)

        My ASCII was converted to the symbol! This is the code I used:
        http://www.theasciicode.com.ar/ascii-printable-characters/greater-than-sign-inequality-ascii-code-62.html

  3. Brenda says:
    VA:F [1.9.22_1171]
    Rating: +1 (from 1 vote)

    I can’t get sorting to work at all. I have this page (http://brendaabell.com/search-downloads/?preview=true&preview_id=4531&preview_nonce=db29123330) with the following shortcode:

    [wpfilebase tag="list" id=14 tpl="data-table" sort="file_name" showcats="0" pagenav="1" /]

    It simply refuses to sort by file name. I’ve tried setting the default in settings and my list is still not sorted by file name. In fact, I can’t quite tell what field it’s sorting by… it seems to be quasi-random.

  4. Najeeb says:
    VA:F [1.9.22_1171]
    Rating: 0 (from 0 votes)

    I want to list the files of one category only. [wpfilebase tag="list" id=3 tpl=data-table ] is showing nothing it only works if i remove the id and shows all the files.

  5. plasmatixx says:
    VN:F [1.9.22_1171]
    Rating: 0 (from 0 votes)

    i search a filebase pro search-form short code.

  6. Raushan Kumar says:
    VA:F [1.9.22_1171]
    Rating: 0 (from 0 votes)

    Packers and Movers Bangalore @
    http://www.expert5th.in/packers-and-movers-bangalore/

  7. Anushka Jain says:
    VA:F [1.9.22_1171]
    Rating: 0 (from 0 votes)

    Packers and Movers Pune @
    http://www.expert5th.in/packers-and-movers-pune/

  8. Zip Lehnus says:
    VA:F [1.9.22_1171]
    Rating: +3 (from 3 votes)

    If I insert two file lists onto one page, like:
    [wpfilebase id=1 tag=list tpl=data-table /]
    [wpfilebase id=2 tag=list tpl=data-table /]
    the second list does NOT display as tpl=data-table. Only the first list with “data-table” works correctly. for example,
    [wpfilebase id=1 tag=list tpl=table /]
    [wpfilebase id=2 tag=list tpl=data-table /]
    [wpfilebase id=3 tag=list tpl=data-table /]
    in this case, only id=2 displays as data-table; id=3 displays as “table”

    why is this? is there a fix or a workaround?
    Thank you…

    1. Abdelhadi says:
      VN:F [1.9.22_1171]
      Rating: +2 (from 2 votes)

      I’m facing the same issue and looking for a solution. I hope the author fix this problem by enabling multiple instances of the same shortcode in a post or a page.

  9. VA:F [1.9.22_1171]
    Rating: 0 (from 0 votes)

    Very useful information is presented in a very simple manner.
    http://instafollowersjunction.com

  10. VA:F [1.9.22_1171]
    Rating: 0 (from 0 votes)

    Thanks for the coding part. I am an amateur coder, who is trying to learn the art of coding. Your website is a great place to get good info.

Leave a Reply to Instagram followers free Cancel reply

Your email address will not be published.