{"id":1408,"date":"2024-11-18T14:30:24","date_gmt":"2024-11-18T14:30:24","guid":{"rendered":"https:\/\/help.xodox.in\/?post_type=docs&#038;p=1408"},"modified":"2024-12-11T14:07:03","modified_gmt":"2024-12-11T14:07:03","password":"","slug":"add-new-project-status","status":"publish","type":"docs","link":"https:\/\/help.xodox.in\/pt\/docs\/add-new-project-status\/","title":{"rendered":"Add New Project Status"},"content":{"rendered":"<div class=\"entry-content\">\n<h4 id=\"note-this-feature-is-available-starting-from-version-1-6-2\" class=\"wp-block-heading\"><strong>NOTE: This feature is available starting from Latest Update<\/strong><\/h4>\n<p>By default Xodox CRM ships with 5 predefined statuses, Not Started, In Progress, On Hold, Cancelled, Finished\u00a0but you can inject new statuses with simple action hook to fit for your needs.<\/p>\n<div class=\"st-alert st-alert-info\">The statuses\u00a0<strong>Not Started<\/strong> and <strong>Finished\u00a0<\/strong>are core statuses and should remain untouched in order everything to works well.<\/div>\n<p>We assume that you have some basic knowledge of reading php code for this article but wont be that hard if you don\u2019t have. You can just copy and paste the code and adjust the keys for your needs (see below keys explanation).<\/p>\n<p>In this example you will add 1\u00a0new project status\u00a0with name <strong>Planning<\/strong><\/p>\n<p>In <strong>application\/helpers<\/strong> create file <strong>my_functions_helper.php<\/strong> and add the following code:<\/p>\n<pre class=\"wp-block-code\"><code>&lt;?php\r\n\r\nhooks()-&gt;add_filter('before_get_project_statuses','my_add_custom_project_status');\r\n\r\nfunction my_add_custom_project_status($current_statuses){\r\n    \/\/ Push new status to the current statuses\r\n    $current_statuses[] = array(\r\n           'id'=&gt;50, \/\/ new status with id 50\r\n           'color'=&gt;'#989898',\r\n           'name'=&gt;'Planning',\r\n           'order'=&gt;10,\r\n           'filter_default'=&gt;true, \/\/ true or false\r\n        );\r\n    \/\/ Return the statuses\r\n    return $current_statuses;\r\n}<\/code><\/pre>\n<div class=\"st-alert st-alert-\">The ID for each status must to be unique.<\/div>\n<ul>\n<li><strong>id<\/strong> \u2013 The id of the project status, its recommended to <strong>add higher id number<\/strong> to prevent overlapping the default system id\u2019s for the project statuses. Eq now currently there is projects statuses with id 1, 2, 3, 4 and 5 and in a future if new default project statuses is added with an id 6 and you already have injected your own status with id 6 can cause issues. <strong>Its not recommended to change the ID after there is project that are using the status id.<\/strong><\/li>\n<li><strong>color<\/strong> \u2013 Color for this status in hex format.<\/li>\n<li><strong>name<\/strong> \u2013 The name of the status that will be displayed to users.<\/li>\n<li><strong>order<\/strong> \u2013 The order of the status.<\/li>\n<li><strong>filter_default<\/strong> \u2013 This option is used if you want to exclude the projects that are using this status by default to be included in the lists tables. Eq if this option is false when you access the projects lists area by default the projects that are using to this status wont be shown and you will neeed manually to use the filters to include in the table.<\/li>\n<\/ul>\n<p>After you adjust the code to fit for your needs save the file my_functions_helper.php and you will be able to see your new project status.<\/p>\n<\/div>","protected":false},"excerpt":{"rendered":"<p>NOTE: This feature is available starting from Latest Update By default Xodox CRM ships with 5 predefined statuses, Not Started, In Progress, On Hold, Cancelled, Finished\u00a0but you can inject new statuses with simple action hook to fit for your needs. The statuses\u00a0Not Started and Finished\u00a0are core statuses and should remain untouched in order everything to works well. We assume that you have some basic knowledge of reading php code for this article but wont be that hard if you don\u2019t have. You can just copy and paste the code and adjust the keys for your needs (see below keys explanation). In this example you will add 1\u00a0new project status\u00a0with name Planning In application\/helpers create file my_functions_helper.php and add the following code: &lt;?php hooks()-&gt;add_filter(&#8216;before_get_project_statuses&#8217;,&#8217;my_add_custom_project_status&#8217;); function my_add_custom_project_status($current_statuses){ \/\/ Push new status to the current statuses $current_statuses[] = array( &#8216;id&#8217;=&gt;50, \/\/ new status with id 50 &#8216;color&#8217;=&gt;&#8217;#989898&#8217;, &#8216;name&#8217;=&gt;&#8217;Planning&#8217;, &#8216;order&#8217;=&gt;10, &#8216;filter_default&#8217;=&gt;true, \/\/ true or false ); \/\/ Return the statuses return $current_statuses; } The ID for each status must to be unique. id \u2013 The id of the project status, its recommended to add higher id number to prevent overlapping the default system id\u2019s for the project statuses. Eq now currently there is projects statuses with id 1, 2, 3, 4 and 5 and in a future if new default project statuses is added with an id 6 and you already have injected your own status with id 6 can cause issues. Its not recommended to change the ID after there is project that are using the status id. color \u2013 Color for this status in hex format. name \u2013 The name of the status that will be displayed to users. order \u2013 The order of the status. filter_default \u2013 This option is used if you want to exclude the projects that are using this status by default to be included in the lists tables. Eq if this option is false when you access the projects lists area by default the projects that are using to this status wont be shown and you will neeed manually to use the filters to include in the table. After you adjust the code to fit for your needs save the file my_functions_helper.php and you will be able to see your new project status.<\/p>","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"_acf_changed":false,"footnotes":""},"doc_category":[34,39],"doc_tag":[],"class_list":["post-1408","docs","type-docs","status-publish","hentry","doc_category-projects","doc_category-setup-configuration"],"acf":[],"year_month":"2026-04","word_count":401,"total_views":0,"reactions":{"happy":0,"normal":0,"sad":0},"author_info":{"name":"help-xodox","author_nicename":"help-xodox","author_url":"https:\/\/help.xodox.in\/pt\/author\/help-xodox\/"},"doc_category_info":[{"term_name":"Projects","term_url":"https:\/\/help.xodox.in\/pt\/docs-category\/projects\/"},{"term_name":"Setup &amp; Configuration","term_url":"https:\/\/help.xodox.in\/pt\/docs-category\/setup-configuration\/"}],"doc_tag_info":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v26.3 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Add New Project Status - My CMS<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/help.xodox.in\/pt\/docs\/add-new-project-status\/\" \/>\n<meta property=\"og:locale\" content=\"pt_PT\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Add New Project Status - My CMS\" \/>\n<meta property=\"og:description\" content=\"NOTE: This feature is available starting from Latest Update By default Xodox CRM ships with 5 predefined statuses, Not Started, In Progress, On Hold, Cancelled, Finished\u00a0but you can inject new statuses with simple action hook to fit for your needs. The statuses\u00a0Not Started and Finished\u00a0are core statuses and should remain untouched in order everything to works well. We assume that you have some basic knowledge of reading php code for this article but wont be that hard if you don\u2019t have. You can just copy and paste the code and adjust the keys for your needs (see below keys explanation). In this example you will add 1\u00a0new project status\u00a0with name Planning In application\/helpers create file my_functions_helper.php and add the following code: &lt;?php hooks()-&gt;add_filter(&#039;before_get_project_statuses&#039;,&#039;my_add_custom_project_status&#039;); function my_add_custom_project_status($current_statuses){ \/\/ Push new status to the current statuses $current_statuses[] = array( &#039;id&#039;=&gt;50, \/\/ new status with id 50 &#039;color&#039;=&gt;&#039;#989898&#039;, &#039;name&#039;=&gt;&#039;Planning&#039;, &#039;order&#039;=&gt;10, &#039;filter_default&#039;=&gt;true, \/\/ true or false ); \/\/ Return the statuses return $current_statuses; } The ID for each status must to be unique. id \u2013 The id of the project status, its recommended to add higher id number to prevent overlapping the default system id\u2019s for the project statuses. Eq now currently there is projects statuses with id 1, 2, 3, 4 and 5 and in a future if new default project statuses is added with an id 6 and you already have injected your own status with id 6 can cause issues. Its not recommended to change the ID after there is project that are using the status id. color \u2013 Color for this status in hex format. name \u2013 The name of the status that will be displayed to users. order \u2013 The order of the status. filter_default \u2013 This option is used if you want to exclude the projects that are using this status by default to be included in the lists tables. Eq if this option is false when you access the projects lists area by default the projects that are using to this status wont be shown and you will neeed manually to use the filters to include in the table. After you adjust the code to fit for your needs save the file my_functions_helper.php and you will be able to see your new project status.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/help.xodox.in\/pt\/docs\/add-new-project-status\/\" \/>\n<meta property=\"og:site_name\" content=\"My CMS\" \/>\n<meta property=\"article:modified_time\" content=\"2024-12-11T14:07:03+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Tempo estimado de leitura\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutos\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/help.xodox.in\/docs\/add-new-project-status\/\",\"url\":\"https:\/\/help.xodox.in\/docs\/add-new-project-status\/\",\"name\":\"Add New Project Status - My CMS\",\"isPartOf\":{\"@id\":\"https:\/\/help.xodox.in\/#website\"},\"datePublished\":\"2024-11-18T14:30:24+00:00\",\"dateModified\":\"2024-12-11T14:07:03+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/help.xodox.in\/docs\/add-new-project-status\/#breadcrumb\"},\"inLanguage\":\"pt-PT\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/help.xodox.in\/docs\/add-new-project-status\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/help.xodox.in\/docs\/add-new-project-status\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/help.xodox.in\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Add New Project Status\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/help.xodox.in\/#website\",\"url\":\"https:\/\/help.xodox.in\/\",\"name\":\"My CMS\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\/\/help.xodox.in\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/help.xodox.in\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"pt-PT\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/help.xodox.in\/#organization\",\"name\":\"My CMS\",\"url\":\"https:\/\/help.xodox.in\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"pt-PT\",\"@id\":\"https:\/\/help.xodox.in\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/help.xodox.in\/wp-content\/uploads\/2024\/10\/Xodox-Logo-01-2.png\",\"contentUrl\":\"https:\/\/help.xodox.in\/wp-content\/uploads\/2024\/10\/Xodox-Logo-01-2.png\",\"width\":573,\"height\":192,\"caption\":\"My CMS\"},\"image\":{\"@id\":\"https:\/\/help.xodox.in\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Add New Project Status - My CMS","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/help.xodox.in\/pt\/docs\/add-new-project-status\/","og_locale":"pt_PT","og_type":"article","og_title":"Add New Project Status - My CMS","og_description":"NOTE: This feature is available starting from Latest Update By default Xodox CRM ships with 5 predefined statuses, Not Started, In Progress, On Hold, Cancelled, Finished\u00a0but you can inject new statuses with simple action hook to fit for your needs. The statuses\u00a0Not Started and Finished\u00a0are core statuses and should remain untouched in order everything to works well. We assume that you have some basic knowledge of reading php code for this article but wont be that hard if you don\u2019t have. You can just copy and paste the code and adjust the keys for your needs (see below keys explanation). In this example you will add 1\u00a0new project status\u00a0with name Planning In application\/helpers create file my_functions_helper.php and add the following code: &lt;?php hooks()-&gt;add_filter('before_get_project_statuses','my_add_custom_project_status'); function my_add_custom_project_status($current_statuses){ \/\/ Push new status to the current statuses $current_statuses[] = array( 'id'=&gt;50, \/\/ new status with id 50 'color'=&gt;'#989898', 'name'=&gt;'Planning', 'order'=&gt;10, 'filter_default'=&gt;true, \/\/ true or false ); \/\/ Return the statuses return $current_statuses; } The ID for each status must to be unique. id \u2013 The id of the project status, its recommended to add higher id number to prevent overlapping the default system id\u2019s for the project statuses. Eq now currently there is projects statuses with id 1, 2, 3, 4 and 5 and in a future if new default project statuses is added with an id 6 and you already have injected your own status with id 6 can cause issues. Its not recommended to change the ID after there is project that are using the status id. color \u2013 Color for this status in hex format. name \u2013 The name of the status that will be displayed to users. order \u2013 The order of the status. filter_default \u2013 This option is used if you want to exclude the projects that are using this status by default to be included in the lists tables. Eq if this option is false when you access the projects lists area by default the projects that are using to this status wont be shown and you will neeed manually to use the filters to include in the table. After you adjust the code to fit for your needs save the file my_functions_helper.php and you will be able to see your new project status.","og_url":"https:\/\/help.xodox.in\/pt\/docs\/add-new-project-status\/","og_site_name":"My CMS","article_modified_time":"2024-12-11T14:07:03+00:00","twitter_card":"summary_large_image","twitter_misc":{"Tempo estimado de leitura":"2 minutos"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/help.xodox.in\/docs\/add-new-project-status\/","url":"https:\/\/help.xodox.in\/docs\/add-new-project-status\/","name":"Add New Project Status - My CMS","isPartOf":{"@id":"https:\/\/help.xodox.in\/#website"},"datePublished":"2024-11-18T14:30:24+00:00","dateModified":"2024-12-11T14:07:03+00:00","breadcrumb":{"@id":"https:\/\/help.xodox.in\/docs\/add-new-project-status\/#breadcrumb"},"inLanguage":"pt-PT","potentialAction":[{"@type":"ReadAction","target":["https:\/\/help.xodox.in\/docs\/add-new-project-status\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/help.xodox.in\/docs\/add-new-project-status\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/help.xodox.in\/"},{"@type":"ListItem","position":2,"name":"Add New Project Status"}]},{"@type":"WebSite","@id":"https:\/\/help.xodox.in\/#website","url":"https:\/\/help.xodox.in\/","name":"My CMS","description":"","publisher":{"@id":"https:\/\/help.xodox.in\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/help.xodox.in\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"pt-PT"},{"@type":"Organization","@id":"https:\/\/help.xodox.in\/#organization","name":"My CMS","url":"https:\/\/help.xodox.in\/","logo":{"@type":"ImageObject","inLanguage":"pt-PT","@id":"https:\/\/help.xodox.in\/#\/schema\/logo\/image\/","url":"https:\/\/help.xodox.in\/wp-content\/uploads\/2024\/10\/Xodox-Logo-01-2.png","contentUrl":"https:\/\/help.xodox.in\/wp-content\/uploads\/2024\/10\/Xodox-Logo-01-2.png","width":573,"height":192,"caption":"My CMS"},"image":{"@id":"https:\/\/help.xodox.in\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/help.xodox.in\/pt\/wp-json\/wp\/v2\/docs\/1408","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.xodox.in\/pt\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/help.xodox.in\/pt\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/help.xodox.in\/pt\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/help.xodox.in\/pt\/wp-json\/wp\/v2\/comments?post=1408"}],"version-history":[{"count":0,"href":"https:\/\/help.xodox.in\/pt\/wp-json\/wp\/v2\/docs\/1408\/revisions"}],"wp:attachment":[{"href":"https:\/\/help.xodox.in\/pt\/wp-json\/wp\/v2\/media?parent=1408"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/help.xodox.in\/pt\/wp-json\/wp\/v2\/doc_category?post=1408"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/help.xodox.in\/pt\/wp-json\/wp\/v2\/doc_tag?post=1408"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}