ROMERO, запомните, программирование - это не какая-то магия, там всегда всё логично. Во многих случаях не надо знать языка и даже уметь программировать, достаточно развитой логики.
JHTML::_('select.option',$i,$i.'- комнатная квартира');
это просто вызов функции
JHTML::_ с тремя разделёнными запятой параметрами,
где первый параметр
'select.option' - говотрит что мы генерируем <option> для <select>;
второй параметр
$i задаёт value для этого <option>;
третий параметр
$i.'- комнатная квартира' - задаёт текст для этого <option>.
В итоге мы получаем
<select>
<option value="$i">$i.'- комнатная квартира'</option>
</select>
где
$i - переменная php содержащая цифру;
. - оператор php означающий склеивание текста;
'- комнатная квартира' - просто текст.
Поэтому убрав "вторую $i" вы просто перестали склевать отображаемый текст с цифрой.
Но в целом это всё основы основ, если собираетесь делать хоть что-то отличное от стандарта - вам таки придётся их изучить.