FuelPHPを使ったリレーションがやっとわかったのでメモしておきます。
要件は下記の通り。

テーブル「カード」と、
テーブル「ユーザーが所持するカード一覧」の２種類を用意し、
特定のユーザーが持っているカードだけ抽出する

テーブルの作成

まずは「カード」のテーブルを作成します。
カードID、カード名だけの単純なテーブルです。

CREATE TABLE `testdb`.`table_card` (
`cardid` VARCHAR( 32 ) NOT NULL UNIQUE,
`name` VARCHAR( 256 ),
INDEX ( `cardid` )
) ENGINE = MYISAM ;

次にユーザーが所有するカードの一覧のテーブルです。
こちらもシリアル、ユーザーID、カードID、枚数だけの単純なもの。

CREATE TABLE `testdb`.`table_userscard` (
`id` SERIAL NOT NULL DEFAULT NULL UNIQUE,
`userid` VARCHAR( 256 ),
`cardid` VARCHAR( 32 ),
`count` INT,
INDEX ( `id` )
) ENGINE = MYISAM ;

ORMモデルの準備

単純な \Fuel\Core\Model_Crud ではなく、\Orm\Model を使います。

ORM（オブジェクトリレーショナルマッパー）はざっくり言うと“リレーションを組むのに便利なモデル”です。
ORMを使うには事前に準備が必要になります。

≫Introduction - Relations - Orm Package - FuelPHP Documentation
≫FuelPHPのORM（オブジェクトリレーショナルマッパー） | WinRoad徒然草
≫FuelPHPをやってみる (8) - Orm\Modelを試す - - kinjou_jのメモログ

モデルの作成

いよいよORMを継承したクラスを作ります。

まずはユーザーの所有カード。
バリデーションの設定など色々行えますが、ここではシンプルに。

fuel/app/classes/model/userscard.php

class Model_Userscard extends \Orm\Model{
  protected static $_table_name = 'table_userscard';
  protected static $_primary_key = array('id');
  protected static $_propeties = array(
    'id',
    'userid',
    'cardid',
    'count'
  );
}

そしてリレーションを設定するカードのモデル。

fuel/app/classes/model/card.php

class Model_Card extends \Orm\Model{
  protected static $_table_name = 'table_card';
  protected static $_primary_key = array('cardid');
  protected static $_propeties = array(
    'cardid',
    'name'
  );

  /**********************************
   * リレーション：一対多
   */
  protected static $_has_many = array(
    'owncard' => array(
      'model_to' => 'Model_Userscard',
      'key_from' => 'cardid',
      'key_to' => 'cardid',
      'cascade_save' => false,
      'cascade_delete' => false
    )
  );
}

key_from、key_toで結合する項目を指定しています。
また、cascade_save、cascade_deleteは「false」にして、カード情報を変更や削除しても、所有情報には影響が出ないようにしています。

コントローラーからの呼び出し

そしていよいよ本番！　リレーションを使い、かつ、リレーション内での絞り込みです。

$results = Model_Card::find( 'all', array(
  'related' => array(
    'owncard' => array(   // リレーション条件を指定
      'where'=> array(    // リレーション内での検索
        array( 'userid', '=', 'ABC12345' )
      )
    )
  ),
// table_card 側での検索はこっちに記述
//  'where' => array(
//    array( 'exp' => 3 )
//  ),
  'order_by' => array( 'cardid'=> 'asc' )
));

モデル内で作成したリレーション条件名を「related」で指定し、
その中で同じように「where」を指定するだけなのですが、
これがなぜか情報が見付かりませんでした。^^;

同じ状況で悩んでいる方のお役に立てればと。

ORMモデルの注意点

\Orm\Model を継承した場合と、\Fuel\Core\Model_Crud を継承した場合ではメソッド名も違いますし、取得できるデータ形式もだいぶ違いますので注意が必要です。

一度 var_dump() で確認してみてください。

FuelPHPで端末によって表示を切り替える方法はいくつかあるようですが、
一番簡単なのは Themeクラスを使うことです。

今回の要件は下記の通り。

• コンテンツ部分を携帯端末とPC・iPadで切り替えたい。
• 共通のベース部分のテンプレートも切り替えたい。
• テンプレートは fuel/app/views/ 内 template_pc.php と template_mobile.php を切り替えて使う。
• コンテンツ部分は fuel/app/views/pc/ と fuel/app/views/mobile/ を切り替えて使う。

fuel 
  + app 
    + classes 
    | + controller 
    |   + list.php　←コントローラー
    |
    + view
      + template_pc.php　←PC用テンプレート
      + template_mobile.php　←携帯用テンプレート
      + pc　　←PC用テーマディレクトリ
      | + list
      |   + index.php
      |
      + mobile　←携帯用テーマディレクトリ
        + list
          + index.php

コントローラー

まずは初期化部分。

fuel/app/classes/controller/list.php

class Controller_List extends Controller{

  function before(){

    parent::before();

    // テーマ設定
    $this->theme = Theme::instance(
      'custom',
      array(
        'active' => "pc",  // 存在するテーマディレクトリを指定
        'fallback' => 'pc',  // activeが存在しない場合に使うテーマ
        'paths' => array(APPPATH.'views'), // 検索パス
        'view_ext' => '.php' // テーマファイル拡張子
      )
    );
    
    // モバイル端末ならテンプレート変更
    // iPadは除外
    if (Agent::browser() != "iPad" && Agent::is_mobiledevice()){
      $this->theme->active('mobile');
      $this->theme->set_template('template_mobile');
    }else{
      $this->theme->active('pc');
      $this->theme->set_template('template_pc');
    }
  }

いったんインスタンスを作る時に active を指定しないとエラーになるので、
PC向けのテーマ（active）を指定して、後から変更しています。

FuelPHPの Agentクラスでは iPadもモバイル端末扱いなのですが、
iPadは PCと同じほうがいいですよねｗ

続いて表示部分。

fuel/app/classes/controller/list.php

  public function action_index()
  {
    $this->theme->template->title = "ページタイトル";
    $this->theme->template->content = $this->theme->view('list/index', Array(
      'hoehoe' => 'ほえほえ'
    ));
    return $this->theme;
  }

タイトルと、テーマ内で使う変数を指定しています。
最後にテーマを返すことで表示させます。

テンプレートファイル

fuel/app/views/template_pc.php

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <title><?php echo $title; ?></title>
</head>
<body>
  <?php echo $content; ?>
  <p>PC用</p>
</body>
</html>

テーマファイル

fuel/app/views/pc/list/index.php

リスト表示するテーマ
<?php echo $hoehoe; ?>

このへんを参考にしました。

≫FuelPHPのテーマクラスのサンプル - BTT's blog
≫FuelPHPのテーマクラス | WinRoad徒然草

その他の方法

この記事のサンプルでは Controllerクラスを継承した方法を使っていますが、Controllerクラスを拡張した Controller_Templateを使う方法もあります。
テンプレートコントローラーでは変数「$template」でテンプレートを指定することが出来ます。

class Controller_Entry extends Controller_Template{
  public $template = 'template_pc';

画面の反映はテーマを使ったのと同じ様なものです。

サンプルでは Controllerクラスを継承していたので return で表示内容を返す必要がありましたが、Controller_Templateクラスを継承している場合その必要はありません。
$this->template 内のものが自動的に表示されます。

  $this->template->content = $this->Theme->view( 'list/index', array('hoehoe'=>'ほえほえ') );

テーマの設定を使って切り替える方法もあるようです。

≫FuelPHPのテーマクラスの概要（実践編その9） | WinRoad徒然草

インストールはこのへんを参考にしました。

≫【PHP】Xdebugを利用したデバッグ環境構築（5.3）
Microsoft Visual C++ 2008 再頒布可能パッケージが必要

≫【PHP】Xdebugを利用したデバッグ環境構築（php5.2）
どのDLLが必要なのか。

≫XAMPPでXDebugを有効にする。 - ぐだぐだ日記
php.iniの設定

≫PHP向けのNetBeans IDEのエディタでのPHPソース・コードのデバッグ

しかしどうやってもインストールできない！！！
おっかしいなーとコマンドプロンプトで「php.exe -v」すると「with Xdebug」の文字が。

インストールできてんじゃん！
でも phpinfo() だと出てこない。なんでだろ？　と思ったら
php.ini 自体が違っていて……。

コマンドプロンプトで実行するときは下記を。
C:\Program Files (x86)\Ampps\php\php.ini
Apacheから実行する時は下記を読んでいたんですね。
C:\Program Files (x86)\Ampps\apache\php.ini

そりゃ動かないわーーー！！