Вообще, по правилам PEAR все инструкции написаны в README. Но там по-английски. А тут я приведу русскую инструкцию. Итак.
1. Надо или установить плагин, как PEAR пакет, или распаковать архив в папку plugins. Папка с плагином должна называться sfPropelTogglerPlugin. После этого вызовите команду symfony 'plugin:publish-assets' чтобы картинки из плагина скопировались в папку web/sfPropelTogglerPlugin. Если ничего не скопировалось - проверьте название папки плагина.
2. В settings.yml вашего приложения впишите в пункт enabled_modules: [default, sfPropelToggler]. Если вы этого не сделаете - будет выскакивать ошибка о том, что модуль не активирован.
3. В том файле, где будете подключать тогглер напишите

use_helper('Toggler');

4. Собственно сам переключатель может быть вставлен 2мя способами. Первый:

echo toggler(array('table' => 'table_name', 'field' => 'field_name', 'id' => $item->getId(), 'state' => $item->getState() ));

Где table -имя таблицы, field - поле, id - первичный ключ записи, а state - текущее состояние переключателя.
Второй способ через объект:

echo object_toggler($object, 'field_name');

Где object - объект Пропела, а field_name - поле, которе будем переключать.

На этом этапе у вас все должно заработать. Если же нет - спрашивайте в комментариях.

Итак что же за переключатели такие? Допустим у нас есть сайт, а у него база данных, а в базе данных таблица, а в таблице поле, которое принимает только 2 значения - 0 и 1. Такие поля делаются типа TINYINT(1). Берем пример из жизни. Одно такое поле отвечает за то, разрешено ли пользователю входить в систему или нет. И если вдруг надо нам попереключать часть пользователей, то надо залезать в свойства каждого и менять, потом сохранять. А мне захотелось жить красивее и придумал я переключатели.

Вот так примерно выглядит список пользователей. Зеленая галочка и красный крестик и есть переключатели. Что сделать чтобы переключить пользователя? Просто кликнуть на них! По клику отправляется AJAX запрос, меняет поле в базе данных и по результатам меняет картинку. Красиво, удобно, быстро. А теперь о том, как это сделано.

Для каждого пользователя в таблице нам надо вставить партиал (partial), который будет отображать картинку. Для формирования таблицы мы foreach перебираем пользователей и вот код partial для переключателя.

<div id="active_<?php echo $user['id']; ?>">
  <?php include_partial('activity', array('id' => $user['id'], 'state' => $user['is_active']))?>
</div>

Как видно в него мы передаем 2 параметра, это id пользователя и его текущий статус. В самом партиалле находится следующий код:

<?php 
$field = 'IsActive';
?>
<div align="center" id="<?php echo $field.'_'.$id ?>">
<?php
include_component('main', 'toggler', array(
  'id' => $id,
  'table' => 'sfGuardUser',
  'state' => sfGuardUserPeer::retrieveByPK($id)->getIsActive(),
  'field' => $field
));
?>
</div>

Здесь $field - имя поля в базе данных. В партиалле создается div с названием $field_$id, куда будет присылаться ответ. Ну а дальше вызывается компонент main/toggler, который и будет собственно переключать. Компоненту мы передаем id пользователя, имя таблицы, текущее состояние и имя поля.

На этом подключение переключателя к модулю завершено. То есть вам надо всего лишь вызвать partial из шаблона, а в partiall'e подправить названия поля и таблицы. Все очень просто и быстро. Ну а собственно что в компоненте main/toggler? А там вот что:
components.class.php

public function executeToggler() {
//i just call _toggler.php partial
}

_toggler.php

<?php
$update = $field.'_'.$id;
sfApplicationConfiguration::getActive()->loadHelpers(array('Javascript'));
$image_name = intval($state)? 'active.png' : 'inactive.png';
echo link_to_remote(image_tag('/images/icons/admin/'.$image_name), array (
   'url' => 'main/toggle?id='.$id.'&table='.$table.'&field='.$field,
   'update' => $update
));
?>

Мы формируем $update - поле, куда вернем ответ. А в виде ответа мы возвращаем... переключатель. Нам надо подгрузить хелпер Javascript (обратите внимание, что надо с большой буквы писать, иначе ничего не получится. симфони требует соблюдения регистра). И с помощью хелпера генерим аяксовую ссылку на экшен, который уже и будет переключать.

Что же получается? Итак общая картинка такая. Мы подключаем partial, который вызывает компонент, который генерит шаблон выдавая нам аяксовую ссылку на действие (action). А экшен переключает нам поле, и рендерит тот же самый компонент.

public function executeToggle(sfWebRequest $request) {
  if (!$request->isXmlHttpRequest()) {
    return $this->renderText('Error. XMLHttpRequests only.');
  }
  $id = $request->getParameter('id');
  $table = $request->getParameter('table');
  $field =  $request->getParameter('field');
  $peer = $this->normalizeName($table).'Peer';
 
  $method = new ReflectionMethod($peer, 'retrieveByPK');
  $object = $method->invoke(NULL, $id);
 
  $setter = 'set'.ucfirst(strtolower($field));
  $getter = 'get'.ucfirst(strtolower($field));
 
  $object->$setter( $state = !$object->$getter() )->save();
   return $this->renderPartial('main/toggler', array('id' => $id, 'state' => $state, 'table' => $table, 'field' => $field));
}
protected function normalizeName($name) {
  $name = preg_replace('/[^a-zA-Z0-9]/', ' ', $name);
  $name = ucwords(strtolower($name));
  $name = str_replace(' ', '', $name);
  return $name;
}

Принимаем только аяксовые запросы, из запроса получаем таблицу, поле и имя Propel Peer-класса для управления таблицей. Имя таблицы мы "нормализуем", т.к. симфони не использует, например, подчеркиваний в названии Peer-классов. Ну а дальше, с помощью рефлексии мы вызываем метод для того, чтобы получить объект, над которым производим действия. Геттеры и сеттер имеют стандартные названия и их рефлексить нам не надо. После чего в ответ рендерим тот же самый компонент, который вернет нам картинку с аяксовой ссылкой на то же самое действие.

Я догадываюсь, что это не так просто понять. Если будет совсем не в моготу - задавайте вопросы в комментариях.