- Posted by JMSolo
- On January 24, 2017
Note: in order to use this method, you will need to update to the latest v2.4.8 QuickBox. To do this, login to your server via ssh or the included Web Console on your dashboard and gain root access by typing sudo su. Next, type box upgrade. Now wait for the update to finish… finito! You’re on your way to adding custom items in QuickBox.
Don’t like ssh? Don’t worry about it! Just update right from the WebUI of your Dashboard!
In this simple how-to, I will be showing you how to create your own custom links/custom menu to the QuickBox Dashboard.
It’s fairly simple and straight-forward. Let’s take a look.
1. Open the custom.menu.php file located in the
You’ll see that we’ve included a quick guide there as well.
2. Under the section titled::
// INSERT YOUR CUSTOM EXTERNAL or INTERNAL LINKS HERE! //
Add a link to your custom location. This is an easy way to segregate your links, from your visible menu entry.
- $appURL = "https://" . $_SERVER['HTTP_HOST'] . ":0000/"; -or-
- embyURL= "https://" . $_SERVER['HTTP_HOST'] . "/emby"; -or-
- externalsiteURL= "https://somewebsite.com";
- $appURL= is used to define what exactly appURL is when it is included within the menu.
- "https://" . $_SERVER['HTTP_HOST'] . " is used to define the address of your server. This is handy for accessing the link via both IP as well as a fully qualified domain name.
:0000/ is used to define the port of your custom application. This only applies if there is a port to be used. For instance, emby defaults on port 8096, thus that entry would like like:
embyURL= "https://" . $_SERVER['HTTP_HOST'] . ":8096/";
- When using external links (outside the server) just use the actual link to the website such as the example for the $externalsiteURL example above.
3. Next, under the section titled:
// INSERT YOUR CUSTOM EXTERNAL or INTERNAL MENU ITEMS HERE! //
You will make use of your $appURL that was defined above. Remember, you can change $appURL to anything you like. Just make sure when you use it in your menu, it stays consistence with the title you gave it above.
Let’s link to the QuickBox Plaza!
1<li><a class="grayscale" href="<?php echo "$quickboxURL"; ?>" target="_blank"><img src="img/brands/quickbox.png" class="brand-ico"> <span>QuickBox Plaza</span></a></li>
$quickboxURL= would be defined at the top of the file.It would link to the Plaza with the following:
- $quickboxURL= "https://plaza.quickbox.io";
- You can see that it is then inserted as a link here:
- href="<?php echo "$quickboxURL"; ?>"
4. Adding Logo Images to your custom links* You can add custom logos to your created menu items by placing the logos within the /srv/rutorrent/home/img/brands/ directory. For best results, add images to be no greater than 128×128 pixels in size.
💡 Remember to change the image source to the name you have given your logo icon.
Any image format is acceptable: (jpg,png,svg,gif)
<img src="img/brands/CHANGETHIS.png" class="brand-ico">
Whereas CHANGETHIS.png is the image.png that you would add.
Feeling sort of confused or overwhelmed?
No worries, we have included a living example within the file and the update applies a custom item, it’s non other than a no-follow link to the QuickBox Plaza. Feel free to keep this or remove it… it’s your custom menu, so add away!
What does this file look like on the inside?