Why can't a section both have hasUrls set to false and a template configured?

[pieterbeulque]

cms/src/services/Sections.php

Lines 649 to 655 in e97588f

	if ($siteSettingsRecord->hasUrls = $siteSettings['hasUrls']) {
	$siteSettingsRecord->uriFormat = $siteSettings['uriFormat'];
	$siteSettingsRecord->template = $siteSettings['template'];
	} else {
	$siteSettingsRecord->uriFormat = $siteSettings['uriFormat'] = null;
	$siteSettingsRecord->template = $siteSettings['template'] = null;
	}

I'm having trouble using Craft::$app->sections->saveSection($section) to create a section with settings configured like this:

new Section_SiteSettings([
  'siteId' => $site->id,
  'hasUrls' => false,
  'uriFormat' => 'IGNORE', // This is neccessary to skip validation errors, somehow
  'template' => 'myTemplate',
]);

Am I trying to do something that I shouldn't try to do or is this a bug?

[pieterbeulque]

It worked with these Section_SiteSettings. I found the answer in #2525.

new Section_SiteSettings([
  'siteId' => $site->id,
  'hasUrls' => true,
  'uriFormat' => '__home__', // This is a magic keyword, apparently
  'template' => 'myTemplate',
]);

[brandonkelly]

If you don’t want the section to have URLs, then you should just leave the uriFormat set to null (or don't include the line at all).

[pieterbeulque]

@brandonkelly, that's what I thought, but that threw a validator error saying uriFormat cannot be blank.

[brandonkelly]

@pieterbeulque The only time uriFormat is required is if the section type is a Single, or if hasUrls is true.

[pieterbeulque]

OK, then it threw the validation error because it was a single.

Thanks for clarifying this, @brandonkelly!