help!

Permalink 2 users found helpful
I feel like I missed step one somewhere in figuring out how to work with concrete5. I am very confused about your_site_root/concrete/themes or /files or /anything that people keep talking about with how to solve a variety of different problems. I can't seem to navigate to these mysterious places and all the answers and guides seem to skip some crucial steps in how to actually find these places for complete beginners.

 
mesuva replied on at Permalink Best Answer Reply
mesuva
Alright, I'll try my best to explain these basics:

- The things you are referring to are the actual folders in the file system that make up parts of concrete5. You'll only see these folders if you look directly at your webserver's files. For the majority of editing tasks, you don't have to concern yourself with these folders and you won't seem them referenced from within concrete5's dashboard/interface. Some CMS will directly show files and folders of the file system in an admin - concrete5 doesn't do that.

- In fact, don't EVER edit anything within the /concrete folder. This is the 'core' folder and holds all the files that makes concrete5 run. When concrete5 is upgraded a version, it's this folder that effectively gets replaced, hence why you never want to make changes to it directly - they'll get overridden in an update (or you might break something).

- Also, for all intensive purposes you shouldn't edit anything in the /files directory. This is where uploaded files are stored, but you don't ever upload files to these folder directly, instead you use concrete5's file manager to upload and manage files. Just let it do it's thing.

- Any of the themes found in /concrete/themes are the base included themes, where if you looked you'd see template and css files, but again you don't directly edit these themes (because it's in /concrete). If you want to make visual changes, the built in themes and many from the marketplace allow you to customise them safely via the dashboard, see: http://www.concrete5.org/documentation/using-concrete5/dashboard/pa...

- You will see through the forums cases where people talk about adding files to top level directories. In these cases it is where people are wanting to 'override' existing concrete5 functionality or output. If you do look at the folder structure you'll see a bunch of top level folders where most of them are empty. The idea is that if there is something you want to adjust, you can drop copies of files into these top level directories and they'll override the core files. This means you can upgrade concrete5 without losing any customisations. http://www.concrete5.org/documentation/introduction/overrides...
It's only if you've exhausted your options using the actual editing interface of concrete5 that you'd look to putting in overrides. In other words, this is for developers, not site editors.

- The most common 'beginner' reasons why you might start looking at the actual folders of concrete5 are when you are either wanting to build your own theme (so you'd put something in the /themes or /packages directory), or you are wanting to override the output for a block. For example, you might use the Page List block to output a list of pages, but you might want to tweak the way the HTML is output - in this case you can create a template for the block and put that in the top level /blocks folder. Then you can select your custom template for the block, allowing you to create a custom output. Between creating a custom themes and creating custom block templates, you can basically control the entire HTML output of concrete5! There are lots of how-tos and guides in the doco on how to do both.

- Let me stress though, the folders you are mentioned AREN'T intended to be edited by complete beginners, hence why they're not really mentioned in the beginner documentation. Complete beginners should be installing concrete5 and building their site via concrete5's editing interface. New themes and add-ons can be installed via the marketplace and that takes care of putting the files and folders in place. It's only when you are wanting to start to customise your site further that you'd consider these folders.
stazi replied on at Permalink Reply
Thanks so much! That is all very helpful information. The things I want to change are the 'login to edit this site' in the footer that does not seem to be customizable in the dashboard, and I would like to try to upload an old database.

So I still have a bit of the original question, how do I access the root directory or the /themes folder?
designserve replied on at Permalink Reply 1 Attachment
designserve
stazi,

The explanation you need is in the documentation here:

http://www.concrete5.org/documentation/how-tos/editors/customize-a-...

I've attached a PDF file to illustrate exactly what you need, I hope it helps. Quicker than typing it all out.

I might have got some minor statements wrong in my PDF, not sure whether the initial theme has to be installed but anyway it works for me.

Cheers.
designserve replied on at Permalink Reply
designserve
stazi,

mesuva's response to your post is brilliant please take time to read it carefully. I'll try to chip in and help out if I'm able. I joined this site around 2010 and it took me about a year to realise everything he has just told you in one post :D

mesuva, just a quick note to say that I took a look at your site and the ones you have designed. What great work!