Files/paths available for custom themes #3808

New Issue

OVERLORD · 2026-02-05T07:32:27+03:00

OVERLORD commented

2026-02-05 07:32:27 +03:00

Originally created by @phelgren on GitHub (May 20, 2023).

Attempted Debugging

I have read the debugging page

Searched GitHub Issues

I have searched GitHub for the issue.

Describe the Scenario

My goal, like many I have read here, is to basically present the book content. Period. No activity lists, no action or revisions listed. Just the book and being able to navigate the pages. Really, just trying to eliminate the sidebars, mostly.

I looked at the approach for hiding the sidebar blocks using css and it seems a bit insecure and hacky. I was hoping that the custom theme option would do the trick. It does, sort of. I was able to successfully modify a file in the root of "home" under views. But I was not successful in making changes to the files in "parts". That is, under my custom theme folder I created a "parts" folder and added the file, sidebar.blade.php to it and made a change, but it was not reflected on the page. I also tried just putting the file in the root of my custom themes folder but that didn't work either. It does work for default, books and specific-page blades.

So, is it supposed to work for the "parts" folder as well? My final solution was to just change the views/home/parts/sidebar.blade.php file directly, which did work. But being able to modify any file in the "views" folder including subfolders would be a real plus.

Is there any way to do that? Or will I just have to rely on git to keep track of my changes in non-"home" files and then merge any new updates later? (which is OK, I was just looking for something more elegant)

Exact BookStack Version

v23.05.1

Log Content

No response

PHP Version

8.2.6

Hosting Environment

Windows 10

Originally created by @phelgren on GitHub (May 20, 2023). ### Attempted Debugging - [X] I have read the debugging page ### Searched GitHub Issues - [X] I have searched GitHub for the issue. ### Describe the Scenario My goal, like many I have read here, is to basically present the book content. Period. No activity lists, no action or revisions listed. Just the book and being able to navigate the pages. Really, just trying to eliminate the sidebars, mostly. I looked at the approach for hiding the sidebar blocks using css and it seems a bit insecure and hacky. I was hoping that the custom theme option would do the trick. It does, sort of. I was able to successfully modify a file in the root of "home" under views. But I was not successful in making changes to the files in "parts". That is, under my custom theme folder I created a "parts" folder and added the file, sidebar.blade.php to it and made a change, but it was not reflected on the page. I also tried just putting the file in the root of my custom themes folder but that didn't work either. It does work for default, books and specific-page blades. So, is it supposed to work for the "parts" folder as well? My final solution was to just change the views/home/parts/sidebar.blade.php file directly, which did work. But being able to modify any file in the "views" folder including subfolders would be a real plus. Is there any way to do that? Or will I just have to rely on git to keep track of my changes in non-"home" files and then merge any new updates later? (which is OK, I was just looking for something more elegant) ### Exact BookStack Version v23.05.1 ### Log Content _No response_ ### PHP Version 8.2.6 ### Hosting Environment Windows 10

OVERLORD added the 🐕 Support label 2026-02-05 07:32:27 +03:00

OVERLORD closed this issue

2026-02-05 07:32:33 +03:00

OVERLORD commented

2026-02-05 07:32:36 +03:00

@ssddanbrown commented on GitHub (May 22, 2023):

But being able to modify any file in the "views" folder including subfolders would be a real plus.

Any view should be available to override via the visual theme system.

That is, under my custom theme folder I created a "parts" folder and added the file, sidebar.blade.php to it and made a change, but it was not reflected on the page.

You'll need to have the file at the same path relative to the parent views folder, so to override a views/home/parts/sidebar.blade.php you'd create a <theme_folder>/home/parts/sidebar.blade.php file.

@ssddanbrown commented on GitHub (May 22, 2023): > But being able to modify any file in the "views" folder including subfolders would be a real plus. Any view should be available to override via the visual theme system. > That is, under my custom theme folder I created a "parts" folder and added the file, sidebar.blade.php to it and made a change, but it was not reflected on the page. You'll need to have the file at the same path relative to the parent views folder, so to override a `views/home/parts/sidebar.blade.php` you'd create a `<theme_folder>/home/parts/sidebar.blade.php` file.

OVERLORD commented

2026-02-05 07:32:38 +03:00

@phelgren commented on GitHub (May 22, 2023):

Thanks. I must be blind! You clearly spelled it out in the documentation and somehow that slipped past me in the video.

Thanks for your patience. Even though I am not familiar with Laravel, and PHP isn't my primary language, this framework is pretty sweet.

@phelgren commented on GitHub (May 22, 2023): Thanks. I must be blind! You clearly spelled it out in the documentation and somehow that slipped past me in the video. Thanks for your patience. Even though I am not familiar with Laravel, and PHP isn't my primary language, this framework is pretty sweet.

OVERLORD commented

2026-02-05 07:32:45 +03:00

@ssddanbrown commented on GitHub (May 22, 2023):

Happy I could help!
Will therefore close this issue off.

@ssddanbrown commented on GitHub (May 22, 2023): Happy I could help! Will therefore close this issue off.

Sign in to join this conversation.

Branches Tags

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: starred/BookStack#3808