How do I use the '/custom' folders?

[tothewine]

Hello, I am looking for information. Is there some documentation page about the "custom files" mechanism?
How do the '/custom' and '/client/custom' folders works? Can I patch any file?

What is the procedure if I want to add (or replace) a file in '/client/css' and parsist it across upgrades?

My specific usage case is a css file that needs to be made available in '/client/css/espo/mystyle.css' because it extends the base espo theme and imports many css files.

Update: I think I am going to make an extension that installs the files. Is there a more comprhensive documentation page than https://www.espocrm.com/documentatio...sion-packages/ ?

For example what happens if I replace core files? Are they backupped during installation and restored when the extension is uninstalled?
What if the user upgrades the espo-crm instance while my extension replaced some files?

Is it safe to create a folder in the index directory or the upgrade process would delete it ?

[tanya]

Hello,
read these https://github.com/espocrm/documenta...rces.md#themes

https://www.espocrm.com/blog/how-to-create-custom-entity/

you can override in custom/Espo/Custom almost all from application/Espo with the saving next path, except Core folder
but if it is a class, the namespace has to start from Espo\Custom\.....{path, aftercustom/Espo/Custom}

https://www.espocrm.com/documentation/development/custom-views/

For your need is better to develop your own theme and use it as default. This way is upgrade safe

[concept]

hello, if you can not customize Espo\Core in custom\Espo\Custom, where can I do it?
Thanks

[tothewine]

Thanks for the information! I have solved the issue about the theme.

Now regarding overriding PHP files.. So if I want to modify "espocrm-5.4.4\application\Espo\Modules\Crm\Services\Accoun t.php" I have to make a copy of it to "espocrm-5.4.4\custom\Espo\Custom\Modules\Crm\Services\Acco unt.php" and change the namespace like this ?

namespace Espo\Modules\Crm\Services;
use \Espo\ORM\Entity;
class Account extends \Espo\Services\Record {

namespace Espo\Custom\Modules\Crm\Services;
use \Espo\ORM\Entity;
class Account extends \Espo\Services\Record {

[tanya]

if you want to modify "espocrm-5.4.4\application\Espo\Modules\Crm\Services\Accoun t.php" you have to create a file "espocrm-5.4.4\custom\Espo\Custom\Services\Account.php" with the content

<?php

namespace Espo\Custom\Services;

class Account extends \Espo\Modules\Crm\Services\Account
{
//this class extends  all the methods of \Espo\Modules\Crm\Services\Account, so you can just add new ones or override needed
}

And don't forget to Clear Cache in Administration

[tothewine]

Thanks! I was able to do that.

In the case of "espocrm-5.4.4\client\src\views\fields\base.js" is there a way to override it or I have to do a direct modification ?

[tanya]

you can override view for each field type,but not base.js

https://forum.espocrm.com/forum/general/867-adding-new-field-to-addresses