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. Terry says:
    VA:F [1.9.22_1171]
    Rating: -4 (from 4 votes)

    Hi. We are using your free version but if we would upgrade to your pro version, would it be possible to sync 3 websites together so if we uploaded 1 file on 1 site that it could be added to the other 2 sites automatically? I know its a stretch, but thought I would ask since I do it daily and if possible it would save me heaps of time. Thanks!

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

    facebook

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

    Good page.

  4. VA:F [1.9.22_1171]
    Rating: -3 (from 3 votes)

    Computer Virus is deemed as one of the nasty program which can infiltrate in your computer very badly. It can attack on different versions of Windows-based systems and assail your legitimate browsing programs without any approval. This threat uses several misleading tricks to infiltrate your computer such as accessing spam emails, infected messages, peer to peer file sharing networks and downloading shareware installers from insecure sources. Once activated, it changes the default settings of your internet browsers such as home page, search engine page and so others. What’s worse terrible, it will inject dubious codes to registry editor to get automatic start up process. Therefore, if you want to protect your system from further threat attacks, you must remove this virus from your PC quickly.

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

    Is there any way to sort a file list by a custom category?
    Basically we want to sort files by a priority nothing related to the file details (name size etc), is this possible?

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

    Version 3.4.4 sort= doesn’t work for any sort option

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

      Its the data tables templates, need to tell data tables not to override sort

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

    Hello guys, you can getBranded SMS in Pakistan form Textfame.com

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

    Update sap

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

    Whether you’re managing a bustling restaurant, running a successful bakery, or exploring exciting culinary adventures, Papa’s Games has something for everyone.

Leave a Reply to Peter Cancel reply

Your email address will not be published.